扩展音频

扩展音频保留标准 HTML 音频资源，同时在阅读页显示未播放或播放中的状态图。读者点按状态图后打开播放面板。

适合用在

• 配音或朗读片段
• 环境音与背景音乐
• 需要显示独立封面或播放状态的音频内容

推荐写法

<audio
  class="reeden-audio"
  placeholder="../Images/play.png"
  activestate="../Images/playing.png"
  title="示例音频"
  controls>
  <source src="../Audio/sample.mp3" type="audio/mpeg" />
</audio>

也可以像标准 HTML 一样直接在 audio 上写 src：

<audio
  class="reeden-audio"
  src="../Audio/sample.mp3"
  title="示例音频"
  controls>
</audio>

扩展属性

只有提供 placeholder 时，activestate 才有可见的替换目标。autoplay、loop、muted、preload 和 source 仍遵循标准 HTML 音频写法。

Reeden 优先读取 audio@src；没有 src 时读取第一个 source。推荐提供一个主音频源，并把音频文件和两张状态图都加入 OPF manifest。

常见问题

音频控件出现但无法播放

检查音频路径、OPF manifest、MIME 类型和文件编码。扩展 class 不会修复无效的音频资源。

封面或播放状态图片不显示

确认已经提供 placeholder，它与 activestate 的相对路径以当前 XHTML 文件为基准，并且两张图片都已列入 manifest。只有 activestate 而没有 placeholder 时，不会进入状态图模式。

兼容写法

duokan-audio 是 reeden-audio 的兼容写法。

相关文档

• 图片画廊
• 全屏插图
• 扩展全集