HTML 音频/视频 DOM 参考
HTML 音频和视频 DOM 参考
HTML5 DOM 为 <audio>
和 <video>
元素提供了方法、属性和事件。
HTML 音频/视频方法
方法 | 描述 |
---|---|
addTextTrack() | 向音频/视频添加新的文本轨道 |
canPlayType() | 检查浏览器是否可以播放指定的音频/视频类型 |
load() | 重新加载音频/视频元素 |
play() | 开始播放音频/视频 |
pause() | 暂停当前正在播放的音频/视频 |
HTML 音频/视频属性
属性 | 描述 |
---|---|
audioTracks | 返回一个 AudioTrackList 对象,表示可用的音轨 |
autoplay | 设置或返回音频/视频加载后是否应开始播放 |
buffered | 返回一个 TimeRanges 对象,表示音频/视频的已缓冲部分 |
controller | 返回一个 MediaController 对象,表示音频/视频的当前媒体控制器 |
controls | 设置或返回音频/视频是否应显示控件(如播放/暂停等) |
crossOrigin | 设置或返回音频/视频的 CORS 设置 |
currentSrc | 返回当前音频/视频的 URL |
currentTime | 设置或返回音频/视频的当前播放位置(以秒为单位) |
defaultMuted | 设置或返回音频/视频默认是否应静音 |
defaultPlaybackRate | 设置或返回音频/视频播放的默认速度 |
duration | 返回当前音频/视频的时长(以秒为单位) |
ended | 返回音频/视频是否已播放结束 |
error | 返回一个 MediaError 对象,表示音频/视频的错误状态 |
循环 | 设置或返回音频/视频播放完毕后是否应重新开始 |
mediaGroup | 设置或返回音频/视频所属的分组(用于链接多个音频/视频元素) |
muted | 设置或返回音频/视频是否已静音 |
networkState | 返回音频/视频的当前网络状态 |
paused | 返回音频/视频是否已暂停 |
playbackRate | 设置或返回音频/视频的播放速度 |
played | 返回一个 TimeRanges 对象,表示音频/视频已播放的部分 |
preload | 设置或返回页面加载时是否应加载音频/视频 |
readyState | 返回音频/视频的当前就绪状态 |
seekable | 返回一个 TimeRanges 对象,表示音频/视频的可搜索部分 |
seeking | 返回用户当前是否正在音频/视频中进行跳转 |
src | 设置或返回音频/视频元素的当前源 |
startDate | 返回一个 Date 对象,表示当前时间偏移量 |
textTracks | 返回一个 TextTrackList 对象,表示可用的文本轨道 |
videoTracks | 已弃用。请勿使用。 |
volume | 设置或返回音频/视频的音量 |
HTML 音频/视频事件
事件 | 描述 |
---|---|
abort | 加载音频/视频被中止时触发 |
canplay | 浏览器可以开始播放音频/视频时触发 |
canplaythrough | 浏览器无需停止缓冲即可完整播放音频/视频时触发 |
durationchange | 音频/视频时长发生变化时触发 |
emptied | 当前播放列表为空时触发 |
ended | 当前播放列表结束时触发 |
error | 加载音频/视频时发生错误时触发 |
loadeddata | 浏览器已加载音频/视频当前帧时触发 |
loadedmetadata | 浏览器已加载音频/视频的元数据时触发 |
loadstart | 浏览器开始查找音频/视频时触发 |
pause | 音频/视频已暂停时触发 |
play | 音频/视频已开始播放或不再暂停时触发 |
playing | 音频/视频在暂停或停止缓冲后开始播放时触发 |
progress | 浏览器正在下载音频/视频时触发 |
ratechange | 音频/视频的播放速度发生变化时触发 |
seeked | 用户完成在音频/视频中移动/跳播到新位置时触发 |
seeking | 用户开始在音频/视频中移动/跳播到新位置时触发 |
stalled | 浏览器正在尝试获取媒体数据,但数据不可用时触发 |
suspend | 浏览器有意不获取媒体数据时触发 |
timeupdate | 当前播放位置发生变化时触发 |
volumechange | 音量发生变化时触发 |
waiting | 视频因需要缓冲下一帧而停止时触发 |