帮助:Gramophone

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

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

单个音频

1001 atk.mp3

<gramophone>1001_atk.mp3</gramophone>

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

正文中的播放按钮

攻击语音攻击语音可以直接插在一句话中。

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

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

表格中的语音

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

用途	行内按钮	单行播放器
攻击语音	攻击语音	1001 atk.mp3
受损语音	受损语音	1001 break.mp3

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

带标题的播放列表

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

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

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

用逗号列出多个文件

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

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

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

常用选项

用途	文件列表写法	JSON 写法
默认展开播放列表	`openplaylist="yes"`	`"isPlaylistOpen": true`
循环整个播放列表	`loop="yes"`	`"loop": true`
尝试自动播放	`autostart="yes"`	`"autoPlay": true`

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

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

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

在模板中使用

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

编队语音编队语音

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

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

{{#tag:playbutton|{{{1}}}|title={{{2|{{{1}}}}}}|hidemissing=yes}}

封面与曲目信息

下面使用《炮声的誓言》的官方PV音频（约1分43秒），展示封面、标题、演唱者与专辑栏。这里的“战舰少女R（官方PV）”用于说明音频来源，不是唱片专辑名称。

炮声的誓言（官方PV版）

<gramophone>
{
  "playlist": [
    {
      "audioFileUrl": "炮声的誓言-BV1hW411P7QE-PV.mp3",
      "title": "炮声的誓言（官方PV版）",
      "artist": "祈Inory",
      "album": "战舰少女R（官方PV）",
      "coverImageUrl": "炮声的誓言-BV1hW411P7QE-封面.jpg",
      "navigationUrl": "https://www.bilibili.com/video/BV1hW411P7QE/"
    }
  ]
}
</gramophone>

标题：炮声的誓言（官方PV版）
演唱：祈Inory
作曲：山田高弘
中文作词：墨流离Sumi
混音：LTC
监制：绯川陵彦
出品：幻萌网络
音频与封面来源：战舰少女R艾拉发布的官方PV

coverImageUrl 指向上传的封面文件，title、artist、album 指定播放器显示的信息，navigationUrl 将文件页面按钮链接到原视频。本例不含LRC，暂不显示同步歌词。

同步歌词

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

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

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

旧标签兼容与更多说明

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