Please note, this is a STATIC archive of website developer.mozilla.org from 03 Nov 2016, cach3.com does not collect or store any user information, there is no "phishing" involved.

<audio>

引进于 HTML5

简介

HTML <audio> 元素用于在文档中表示音频内容。 <audio> 元素可以包含多个音频资源, 这些音频资源可以使用 src 属性或者<source> 元素来进行描述; 浏览器将会选择最合适的一个来使用。对于不支持<audio>元素的浏览器,<audio>元素也可以作为浏览器不识别的内容加入到文档中。

你也可以使用Gecko特有的更加强大的audio API特性在JavaScript 代码中直接生成和控制音频流。详情参见 Introducing the audio API extension

使用上下文

  • Content categories Flow content, phrasing content, embedded content. If it has a controls attribute: interactive content and palpable content.
  • 允许内容如果元素包含 src 属性:零个或多个 <track> 元素,其后紧跟不包含 <audio> 或者 <video>媒体元素的透明内容。
    或者:零个或多个 <source> 元素,其后紧跟零个或多个 <track> 元素,其后紧跟不包含 <audio> 或者 <video>媒体元素的透明内容。
  • 标记省略 不允许,开始标签和结束标签都不能省略。
  • 允许的父级元素任何允许 嵌入内容 的元素.
  • DOM 接口 HTMLAudioElement

属性

该元素包含 全局属性

autoplay
布尔属性;如果指定(即使值为"false"!);指定后,音频会马上自动开始播放,不会停下来等着数据载入结束。
autobuffer 已废弃 Gecko 2.0
布尔属性;如果指定,音频将会自动开始加载。即使没有设置自动播放。直到媒体缓存满了或者全部音频文件加载完毕,即使是在首次进入时。该属性应该仅仅用在用户可能会选择播放的音频上;例如用户通过“播放音频”链接来到的一个页面。该属性已在Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1) 中移除,使用preload属性取而代之。
buffered
你可以通过该属性获取已缓冲的资源的时间段信息。该属性包含一个 TimeRanges 对象。
controls
如果设置了该属性,浏览器将提供一个包含声音,播放进度,播放暂停的控制面板,让用户可以控制音频的播放。
loop
布尔属性;如果指定,将循环播放音频。
mozCurrentSampleOffset
在音频播放时,表示相对于音频开始处的偏移量的一个数值。
muted
表示是否静音的布尔值。默认值为false,表示有声音。
played
一个TimeRanges 对象,表示所有已播放的音频片段。
preload
枚举属性,让开发者自行思考来示意浏览器使用何种加载方式以达到最好的用户体验。可以是以下属性之一:
  • none: 示意用户可能不会播放该音频,或者服务器希望节省带宽;换句话说,该音频不会被缓存;
  • metadata: 示意即使用户可能不会播放该音频,但获取元数据 (例如音频长度) 还是有必要的。
  • auto: 示意用户可能会播放音频;换句话说,如果有必要,整个音频都将被加载,即使用户不期望使用。
  • 空字符串 : 等效于auto属性。

假如不设置,默认值就是浏览器定义的了(即,不同浏览器会选择自己的默认值), 即使规范建议设置为 metadata.

使用备注:
  • autoplay 属性优先于 preload 假如用户想自动播放视频,那么很明显浏览器需要下载视频。同时设置autoplay 和 preload属性在规范里是允许的。
  • 规范没有强制浏览器去遵循该属性的值;这仅仅只是个提示。
src
嵌入的音频的URL。 该URL应遵从 HTTP access controls. 这是一个可选属性;你可以在audio元素中使用 <source> 元素来替代该属性指定嵌入的音频。
volume
音频播放的音量。值从0.0 (无声) 到 1.0 (最大声).

时间偏移量目前是指定为float类型的值,表示偏移的秒数。

备注: HTML 5 规范中,时间偏移量值的定义还没有完成,有可能会变更。

事件

audio元素支持的事件

例子

基本用法

<!-- Simple audio playback -->
<audio src="https://developer.mozilla.org/@api/deki/files/2926/=AudioTest_(1).ogg" autoplay>
  Your browser does not support the <code>audio</code> element.
</audio>

<!-- Audio playback with captions -->
<audio src="foo.ogg">
  <track kind="captions" src="foo.en.vtt" srclang="en" label="English">
  <track kind="captions" src="foo.sv.vtt" srclang="sv" label="Svenska">
</audio> 

使用source元素的audio元素

<audio controls="controls">
  Your browser does not support the <code>audio</code> element.
  <source src="foo.wav" type="audio/wav">
</audio>

规范

Specification Status Comment
WHATWG HTML Living Standard
<audio>
Living Standard  
HTML5
<audio>
Recommendation  

浏览器兼容性

特征 Chrome Firefox (Gecko) Internet Explorer Opera Safari
基础支持 3.0 3.5 (1.9.1) 9.0 10.5 3.1
autoplay 属性 3.0 3.5 (1.9.1) 9.0 10.5 3.1
buffered 属性 ? 4.0 (2.0) ? ? ?
controls 属性 3.0 3.5 (1.9.1) 9.0 10.5 3.1
loop 属性 3.0 11.0 (11.0) 9.0 10.5 3.1
muted 属性 ? 11.0 (11.0) ? ? ?
played 属性(property) ? 15.0 (15.0) ? ? ?
preload 属性 3.0 4.0 (2.0) 9.0 Supported under the older name autobuffer 3.1
src 属性 3.0 3.5 (1.9.1) 9.0 10.5 3.1
volume 属性          
特征 Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
基础支持 ? 1.0 (1.0) ? ? ?
autoplay 属性 ? 1.0 (1.0) ? ? ?
buffered 属性 ? 4.0 (2.0) ? ? ?
controls 属性 ? 1.0 (1.0) ? ? ?
loop 属性 ? 11.0 (11.0) ? ? ?
muted 属性 ? 11.0 (11.0) ? ? ?
played 属性(property) ? 15.0 (15.0) ? ? ?
preload 属性 ? 4.0 (2.0) ? ? ?
src 属性 ? 1.0 (1.0) ? ? ?
volume 属性          

备注: 使用Gecko播放音频时,服务器必须提供正确的MIME类型。

另请参阅

文档标签和贡献者

 此页面的贡献者: Gerhut, mage3k, Jyouger, ziyunfei, snadn
 最后编辑者: Gerhut,