HTML Audio/Video 参考手册


HTML音频和视频DOM参考

HTML5 DOM具有<audio>和<video>元素的方法,属性和事件.

这些方法,属性和事件允许您使用JavaScript操作<audio>和<video>元素.


HTML音频/视频(audio/video)方法

方法(Method) 描述
addTextTrack() 向音频/视频(audio/video)添加新的文本轨道
canPlayType() 检测浏览器是否能播放指定的音频/视频(audio/video)类型
load() 重新加载音频/视频(audio/video)元素
play() 开始播放音频/视频(audio/video)
pause() 暂停当前播放的音频/视频(audio/video)

HTML音频/视频(audio/video)属性

属性(Property) 描述
audioTracks 返回表示可用音频轨道的 AudioTrackList 对象
autoplay 设置或返回是否在加载完成后随即播放音频/视频(audio/video)
buffered 返回表示音频/视频(audio/video)已缓冲部分的 TimeRanges 对象
controller 返回表示音频/视频(audio/video)当前媒体控制器的 MediaController 对象
controls 设置或返回音频/视频(audio/video)是否显示控件(比如播放/暂停等)
crossOrigin 设置或返回音频/视频(audio/video)的 CORS 设置
currentSrc 返回当前音频/视频(audio/video)的 URL
currentTime 设置或返回音频/视频(audio/video)中的当前播放位置(以秒计)
defaultMuted 设置或返回音频/视频(audio/video)默认是否静音
defaultPlaybackRate 设置或返回音频/视频(audio/video)的默认播放速度
duration 返回当前音频/视频(audio/video)的长度(以秒计)
ended 返回音频/视频(audio/video)的播放是否已结束
error 返回表示音频/视频(audio/video)错误状态的 MediaError 对象
loop 设置或返回音频/视频(audio/video)是否应在结束时重新播放
mediaGroup 设置或返回音频/视频(audio/video)所属的组合(用于连接多个音频/视频(audio/video)元素)
muted 设置或返回音频/视频(audio/video)是否静音
networkState 返回音频/视频(audio/video)的当前网络状态
paused 设置或返回音频/视频(audio/video)是否暂停
playbackRate 设置或返回音频/视频(audio/video)播放的速度
played 返回表示音频/视频(audio/video)已播放部分的 TimeRanges 对象
preload 设置或返回音频/视频(audio/video)是否应该在页面加载后进行加载
readyState 返回音频/视频(audio/video)当前的就绪状态
seekable 返回表示音频/视频(audio/video)可寻址部分的 TimeRanges 对象
seeking 返回用户是否正在音频/视频(audio/video)中进行查找
src 设置或返回音频/视频(audio/video)元素的当前来源
startDate 返回表示当前时间偏移的 Date 对象
textTracks 返回表示可用文本轨道的 TextTrackList 对象
videoTracks 返回表示可用视频轨道的 VideoTrackList 对象
volume 设置或返回音频/视频(audio/video)的音量

HTML音频/视频(audio/video)事件

事件(Event) 描述
abort 当音频/视频(audio/video)的加载已放弃时触发
canplay 当浏览器可以开始播放音频/视频(audio/video)时触发
canplaythrough 当浏览器可在不因缓冲而停顿的情况下进行播放时触发
durationchange 当音频/视频(audio/video)的时长已更改时触发
emptied 当目前的播放列表为空时触发
ended 当目前的播放列表已结束时触发
error 当在音频/视频(audio/video)加载期间发生错误时触发
loadeddata 当浏览器已加载音频/视频(audio/video)的当前帧时触发
loadedmetadata 当浏览器已加载音频/视频(audio/video)的元数据时触发
loadstart 当浏览器开始查找音频/视频(audio/video)时触发
pause 当音频/视频(audio/video)已暂停时触发
play 当音频/视频(audio/video)已开始或不再暂停时触发
playing 当音频/视频(audio/video)在因缓冲而暂停或停止后已就绪时触发
progress 当浏览器正在下载音频/视频(audio/video)时触发
ratechange 当音频/视频(audio/video)的播放速度已更改时触发
seeked 当用户已移动/跳跃到音频/视频(audio/video)中的新位置时触发
seeking 当用户开始移动/跳跃到音频/视频(audio/video)中的新位置时触发
stalled 当浏览器尝试获取媒体数据,但数据不可用时触发
suspend 当浏览器刻意不获取媒体数据时触发
timeupdate 当目前的播放位置已更改时触发
volumechange 当音量已更改时触发
waiting 当视频由于需要缓冲下一帧而停止时触发