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 | 视频因需要缓冲下一帧而停止时触发 |