Maintenance script：添加炮声的誓言PV封面与曲目信息示例及来源

2026-10-08T02:59:49Z

添加炮声的誓言PV封面与曲目信息示例及来源

@@ 第1行： / 第1行： @@
-本页演示如何用 '''Gramophone''' 在维基页面中插入音频播放器、行内播放按钮和播放列表。点击下方按钮即可试听。示例使用本站已有的三个语音文件，显示名称仅用于说明用途。
+本页演示如何用 '''Gramophone''' 在维基页面中插入音频播放器、行内播放按钮和播放列表。点击下方按钮即可试听。基础示例使用本站已有的三个语音文件，显示名称仅用于说明用途。封面示例使用《炮声的誓言》PV音频。
 编辑页面时，复制各节的维基文本，并将文件名换成已上传的音频文件名。文件名可带 <code>File:</code> 或 <code>文件:</code> 前缀。需要上传新文件时，请先确认你有权使用该音频。
@@ 第114行： / 第114行： @@
 </syntaxhighlight>
-== 封面与同步歌词 ==
+== 封面与曲目信息 ==
-本页尚未选用可配套的封面或 LRC 文件，因此不展示实时歌词。下面只是'''字段写法示意'''，其中的占位文件名不能直接播放，使用前请换成实际文件。
+下面使用《炮声的誓言》的官方PV音频（约1分43秒），展示封面、标题、演唱者与专辑栏。这里的“战舰少女R（官方PV）”用于说明音频来源，不是唱片专辑名称。
 <syntaxhighlight lang="json">

Maintenance script：创建 Gramophone 音频播放器使用说明与示例

2026-10-08T02:47:25Z

创建 Gramophone 音频播放器使用说明与示例

新页面

本页演示如何用 '''Gramophone''' 在维基页面中插入音频播放器、行内播放按钮和播放列表。点击下方按钮即可试听。示例使用本站已有的三个语音文件，显示名称仅用于说明用途。

编辑页面时，复制各节的维基文本，并将文件名换成已上传的音频文件名。文件名可带 <code>File:</code> 或 <code>文件:</code> 前缀。需要上传新文件时，请先确认你有权使用该音频。

== 单个音频 ==
<gramophone>1001_atk.mp3</gramophone>

<syntaxhighlight lang="wikitext">
<gramophone>1001_atk.mp3</gramophone>
</syntaxhighlight>

文件列表形式默认显示文件名。要为完整播放器设置自定义标题，请使用下方的 JSON 播放列表。

== 正文中的播放按钮 ==
攻击语音 <playbutton title="攻击语音">1001_atk.mp3</playbutton> 可以直接插在一句话中。

<syntaxhighlight lang="wikitext">
攻击语音 <playbutton title="攻击语音">1001_atk.mp3</playbutton> 可以直接插在一句话中。
</syntaxhighlight>

<code>title</code> 用于按钮提示、屏幕阅读器及系统媒体控件。它不会自动生成按钮旁边的正文，因此请像示例一样另外写出可见的名称。

== 表格中的语音 ==
单个文件放在表格单元格中时，完整播放器会使用紧凑的单行布局。只需一个按钮时，使用 <code><playbutton></code>。

{| class="wikitable"
! 用途 !! 行内按钮 !! 单行播放器
|-
| 攻击语音 || <playbutton title="攻击语音">1001_atk.mp3</playbutton> || <gramophone>1001_atk.mp3</gramophone>
|-
| 受损语音 || <playbutton title="受损语音">1001_break.mp3</playbutton> || <gramophone>1001_break.mp3</gramophone>
|}

<syntaxhighlight lang="wikitext">
{| class="wikitable"
! 用途 !! 行内按钮 !! 单行播放器
|-
| 攻击语音 || <playbutton title="攻击语音">1001_atk.mp3</playbutton> || <gramophone>1001_atk.mp3</gramophone>
|-
| 受损语音 || <playbutton title="受损语音">1001_break.mp3</playbutton> || <gramophone>1001_break.mp3</gramophone>
|}
</syntaxhighlight>

== 带标题的播放列表 ==
JSON 形式可设置每段音频的标题、艺术家、专辑、封面和歌词。本例只引用已有音频，并在页面打开时展开列表。

<gramophone>
{
"isPlaylistOpen": true,
"playlist": [
{ "audioFileUrl": "1001_atk.mp3", "title": "攻击语音" },
{ "audioFileUrl": "1001_break.mp3", "title": "受损语音" },
{ "audioFileUrl": "1001_formation.mp3", "title": "编队语音" }
]
}
</gramophone>

<syntaxhighlight lang="wikitext">
<gramophone>
{
"isPlaylistOpen": true,
"playlist": [
{ "audioFileUrl": "1001_atk.mp3", "title": "攻击语音" },
{ "audioFileUrl": "1001_break.mp3", "title": "受损语音" },
{ "audioFileUrl": "1001_formation.mp3", "title": "编队语音" }
]
}
</gramophone>
</syntaxhighlight>

JSON 中的字段名和字符串使用双引号，布尔值写为 <code>true</code> 或 <code>false</code>，最后一项后面不要加逗号。播放器选项放在 <code>playlist</code> 同级，音频信息放在各个曲目对象中。

== 用逗号列出多个文件 ==
不需要自定义曲目名称时，用逗号分隔文件名即可。

<gramophone>1001_atk.mp3,1001_break.mp3,1001_formation.mp3|openplaylist=yes</gramophone>

<syntaxhighlight lang="wikitext">
<gramophone>1001_atk.mp3,1001_break.mp3,1001_formation.mp3|openplaylist=yes</gramophone>
</syntaxhighlight>

文件名本身含有逗号时，请用双引号包住整个文件名。<code><playbutton></code> 也接受逗号列表，一个按钮会依次播放其中的文件。

== 常用选项 ==
{| class="wikitable"
! 用途 !! 文件列表写法 !! JSON 写法
|-
| 默认展开播放列表 || <code>openplaylist="yes"</code> || <code>"isPlaylistOpen": true</code>
|-
| 循环整个播放列表 || <code>loop="yes"</code> || <code>"loop": true</code>
|-
| 尝试自动播放 || <code>autostart="yes"</code> || <code>"autoPlay": true</code>
|}

文件列表的选项可写在标签属性中，也可写在文件名后的 <code>|选项=yes</code> 中。两处同时指定时，标签内容中的选项优先，只有 <code>yes</code> 会开启选项。

'''JSON 模式请把这些选项写在 JSON 内部。''' JSON 模式仅接受 <code>class</code> 和 <code>style</code> 标签属性，其余属性会被忽略。浏览器可能阻止自动播放，本页示例均等待读者点击后播放。

对于 <code><playbutton></code>，可用 <code>hidemissing="yes"</code> 隐藏所有候选文件均不存在的按钮，适合部分语音未上传的模板。该选项不适用于完整播放器。

== 在模板中使用 ==
模板参数需要展开时，使用 <code>#tag</code>。下面先演示固定文件名的可运行写法。

编队语音 {{#tag:playbutton|1001_formation.mp3|title=编队语音}}

<syntaxhighlight lang="wikitext">
编队语音 {{#tag:playbutton|1001_formation.mp3|title=编队语音}}
</syntaxhighlight>

以下为'''模板源码示意'''，可放入你自己的语音按钮模板，再以第一个参数传入文件名，以第二个参数传入标题。

<syntaxhighlight lang="wikitext">
{{#tag:playbutton|{{{1}}}|title={{{2|{{{1}}}}}}|hidemissing=yes}}
</syntaxhighlight>

== 封面与同步歌词 ==
本页尚未选用可配套的封面或 LRC 文件，因此不展示实时歌词。下面只是'''字段写法示意'''，其中的占位文件名不能直接播放，使用前请换成实际文件。

<syntaxhighlight lang="json">
{
"playlist": [
{
"audioFileUrl": "请替换为音频文件.mp3",
"title": "显示标题",
"coverImageUrl": "请替换为封面文件.jpg",
"lrcFileUrl": "请替换为歌词文件.lrc",
"lrcFileOffset": 0
}
]
}
</syntaxhighlight>

LRC 每行以时间标记（如 <code>[00:01.00]</code>）开头。<code>lrcFileOffset</code> 以毫秒为单位调整时间。上传 LRC 需要管理员允许该文件扩展名，也可引用可访问的 LRC 地址。请只使用有权发布的歌词或原创说明文字。

== 旧标签兼容与更多说明 ==
Gramophone 默认兼容 <code><flashmp3></code>、<code><sm2></code> 和 <code><modernsoundmanager></code>。它们分别对应文件列表播放器、行内按钮和 JSON 播放器。新页面建议使用本页的 <code><gramophone></code> 与 <code><playbutton></code> 写法。<code><ab></code> 需要管理员单独开启兼容选项。

* [https://github.com/Laoweek/mediawiki-extensions-Gramophone/blob/main/README.zh-CN.md Gramophone 中文说明]
* [https://github.com/Laoweek/mediawiki-extensions-Gramophone/blob/main/docs/reference.md 完整标签参考（英文）]
* [https://github.com/Laoweek/mediawiki-extensions-Gramophone/blob/main/docs/migrating.md 旧扩展迁移说明（英文）]

帮助:Gramophone - 版本历史

Maintenance script：​添加炮声的誓言PV封面与曲目信息示例及来源

Maintenance script：​创建 Gramophone 音频播放器使用说明与示例

Maintenance script：添加炮声的誓言PV封面与曲目信息示例及来源

Maintenance script：创建 Gramophone 音频播放器使用说明与示例