Audio

Audio 对象 对齐 HTMLAudioElement，提供类似 HTMLAudioElement 的能力。

属性

属性名	类型	读写特性	默认值	必填	说明	最低支持版本
src	string	可读写		是	播放音频文件路径	1.34.0
srcObject	ArrayBuffer	可读写		是	支持设置二进制数据的音频源，与 src 属性设置效果一致	1.34.0
currentTime	number	可读写	0	否	当前播放的位置，单位为秒。写操作会定位到设置的时间处	1.34.0
startTime	number	可读写	0	否	从何时开始播放，单位为秒	1.34.0
duration	number	只读	0	否	音频总长度，单位为秒。	1.34.0
volume	number	可读写	1	否	音频音量，范围为 0 到 1	1.34.0
autoplay	boolean	可读写	false	否	是否自动播放	1.34.0
loop	boolean	可读写	false	否	是否循环播放	1.34.0
paused	boolean	只读	true	否	是否处于暂停或停止状态	1.34.0

方法

play()

播放 Audio 音频。

pause()

暂停播放 Audio 音频。

stop()

停止播放 Audio 音频。

oncanplay(function callback)

音频进入可以播放状态，但不保证后面可以流畅播放。

onseeking(function callback)

监听音频进行跳转操作的事件。

onseeked(function callback)

监听音频完成跳转操作（seek）的事件。

onplaying(function callback)

音频开始播放时触发。可能是刚开始播放，也可能是从暂停中恢复播放。

onpause(function callback)

监听音频暂停事件，当调用 pause 暂停播放音频时候触发。

onended(function callback)

监听音频停止事件，当音频播放完毕后触发。

onstop(function callback)

监听音频停止事件，当调用 stop 停止播放音频时候触发。

onwaiting(function callback)

监听音频加载中的事件，当音频因为数据不足，需要停下来加载时会触发。

代码示例

开发者工具中预览

可参考 AudioContext.createAudio 代码示例。