前言
今天在做一个简单的音乐播放器的时候,找一个全面的API就花费了我不少时间:MDN有全面的API但是公司网路打不开,所以在这里记录下,方便下次使用。
属性
| 属性 | 描述 |
|---|---|
| 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 | 设置或返回音频的 preload 属性的值。 |
| readyState | 返回音频当前的就绪状态。 |
| seekable | 返回表示音频可寻址部分的 TimeRanges 对象。 |
| seeking | 返回用户当前是否正在音频中进行查找。 |
| src | 设置或返回音频的 src 属性的值。 |
| textTracks | 返回表示可用文本轨道的 TextTrackList 对象。 |
| volume | 设置或返回音频的音量。 |
方法
| 方法 | 描述 |
|---|---|
| addTextTrack() | 向音频添加新的文本轨道。 |
| canPlayType() | 检查浏览器是否能够播放指定的音频类型。 |
| fastSeek() | 在音频播放器中指定播放时间。 |
| getStartDate() | 返回新的 Date 对象,表示当前时间线偏移量。 |
| load() | 重新加载音频元素。 |
| play() | 开始播放音频。 |
| pause() | 暂停当前播放的音频。 |
事件
| 事件 | 描述 |
|---|---|
| onabort | 在退出时运行的脚本。 |
| oncanplay | 当文件就绪可以开始播放时运行的脚本(缓冲已足够开始时)。 |
| oncanplaythrough | 当媒介能够无需因缓冲而停止即可播放至结尾时运行的脚本。 |
| ondurationchange | 当媒介长度改变时运行的脚本。 |
| onemptied | 当发生故障并且文件突然不可用时运行的脚本(比如连接意外断开时)。 |
| onended | 当媒介已到达结尾时运行的脚本(可发送类似“感谢观看”之类的消息)。 |
| onerror | 当在文件加载期间发生错误时运行的脚本。 |
| onloadeddata | 当媒介数据已加载时运行的脚本。 |
| onloadedmetadata | 当元数据(比如分辨率和时长)被加载时运行的脚本。 |
| onloadstart | 在文件开始加载且未实际加载任何数据前运行的脚本。 |
| onpause | 当媒介被用户或程序暂停时运行的脚本。 |
| onplay | 当媒介已就绪可以开始播放时运行的脚本。 |
| onplaying | 当媒介已开始播放时运行的脚本。 |
| onprogress | 当浏览器正在获取媒介数据时运行的脚本。 |
| onratechange | 每当回放速率改变时运行的脚本(比如当用户切换到慢动作或快进模式)。 |
| onreadystatechange | 每当就绪状态改变时运行的脚本(就绪状态监测媒介数据的状态)。 |
| onseeked | 当 seeking 属性设置为 false(指示定位已结束)时运行的脚本。 |
| onseeking | 当 seeking 属性设置为 true(指示定位是活动的)时运行的脚本。 |
| onstalled | 在浏览器不论何种原因未能取回媒介数据时运行的脚本。 |
| onsuspend | 在媒介数据完全加载之前不论何种原因终止取回媒介数据时运行的脚本。 |
| ontimeupdate | 当播放位置改变时(比如当用户快进到媒介中一个不同的位置时)运行的脚本。 |
| onvolumechange | 每当音量改变时(包括将音量设置为静音)时运行的脚本。 |
| onwaiting | 当媒介已停止播放但打算继续播放时(比如当媒介暂停已缓冲更多数据)运行脚本。 |