WordPress中文开发手册

  1. Home
  2. Docs
  3. WordPress中文开发手册
  4. WordPress主题开发
  5. 主题功能
  6. 媒体
  7. Audio

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('
');

短代码创建音频播放器,如下面的屏幕截图所示。

循环和自动播放

支持以下基本选项:

循环

允许媒体循环。

  • off - 不要循环播放媒体。 默认。
  • on - 媒体将在完成后循环开始,并自动继续播放。

自动播放

导致媒体在媒体文件准备就绪后自动播放。

  • 0 - 不要自动播放媒体。 默认。
  • 1 - 一旦准备就绪,媒体就会播放。

以下示例在页面加载和循环后立即开始播放音乐。

echo do_shortcode('
');

造型

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

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

支持的音频格式

  • mp3
  • ogg
  • wma
  • m4a
  • wav

参考文献

有关更多技术细节,如启用此功能的内部库,请参阅

https://make.wordpress.org/core/2013/04/08/audio-video-support-in-core/.

  • Audio Shortcode
  • Function do_shortcode()