音频

您可以直接使用简单的短代码[audio]嵌入音频文件并进行播放。支持的格式包括 mp3、ogg、wma、m4a 和 wav。

音频短代码

以下短代码用于显示加载 music.mp3 文件的音频播放器:

<<[audio src="music.mp3"]>

要从模板文件中使用此短代码,请使用 do_shortcode 函数。当 music.mp3 文件存储在 (theme_directory)/sounds 目录时,请将以下代码插入到您的模板文件中:

$music_file = get_template_directory_uri() . "/sounds/music.mp3";
echo do_shortcode('[[audio mp3=' . $music_file . ']]');

此短代码会创建如下截图所示的音频播放器。

音频播放器

循环与自动播放

支持以下基本选项:

循环 (loop)

允许媒体文件进行循环播放。

  • "off" – 不循环媒体。默认值。
  • "on" – 当媒体播放结束时,将自动从开头重新开始并继续播放。

自动播放 (autoplay)

导致媒体在文件准备好后立即自动开始播放。

  • 0 – 不自动播放媒体。默认值。
  • 1 – 当媒体准备就绪时立即播放。

以下示例会在页面加载后并循环的情况下,立即开始播放音乐:

<<[audio mp3=' . $music_file . ' loop = "on" autoplay = 1]]>

样式设置

如果您想更改音频播放器的外观,可以通过针对默认类名“wp-audio-shortcode”来实现。如果将以下代码插入到您的 style.css 文件中,则音频播放器的宽度将显示为一半。

.wp-audio-shortcode {
  width: 50%;
}

支持的音频格式

  • mp3
  • ogg
  • wma
  • m4a
  • wav

参考资料

有关内部库等更多技术细节,请参阅