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 对象 |
| loop | 设置或返回音频/视频在播放完毕后是否应重新开始 |
| 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 | 当用户开始移动/跳至音频/视频中的新位置时触发。 |
| 停滞 | 当浏览器尝试获取媒体数据，但数据不可用时触发。 |
| 暂停 | 当浏览器故意不获取媒体数据时触发。 |
| 时间更新 | 当当前播放位置发生变化时触发。 |
| 音量变化 | 当音量发生变化时触发。 |
| 等待 | 当视频因需要缓冲下一帧而停止时触发。 |
