属性/方法名 |
使用约定 |
src |
支持音频格式：aac/mp3 支持传入网络音频链接、也支持传入通过淘宝官方 API 获取的本地虚拟链接 |
startTime |
单位秒，仅允许在 onCanplay() 回调之前设置，播放过程中如需切换位置请使用 seek 双端差异：若指定了 startTime，Android 设备在播放时，会在 onPlay() 回调后会收到 onSeeked() 回调，iOS 上不会收到 |
autoplay |
是否允许自动播放，默认 false |
loop |
是否循环播放，默认 false |
obeyMuteSwitch |
不支持 |
duration |
单位秒，仅允许在 oncanplay() 之后访问 duration |
currentTime |
单位秒 播放前：若设置了 startTime 且 autoplay 为 false 的情况下获取为 0 播放中：返回当前时间 播放完：返回音频长度 |
paused |
当前是否处于暂停或停止状态，true 表示暂停或停止，false 表示正在播放 |
buffered |
返回值格式：百分比 |
volume |
音量， 范围 0~1 |
play |
播放 |
pause |
暂停 |
stop |
停止播放 stop() 被调用后，无法再次调用 seek() stop() 被调用后，无论是否设置过 starttime，再次播放时一律从头开始播放 双端差异：stop() 被调用后，若再次播放，Android 设备会先收到 onCanPlay() 回调，再收到 onPlay() 回调，而 iOS 设备只会收到 onPlay() 回调 |
seek |
单位秒，跳转到指定位置，在 onCanPlay() 后只要不是 stop 状态均可 seek |
事件名 |
使用约定 |
destroy |
销毁当前实例 |
onWaiting |
音频缓冲事件回调 |
onCanplay |
可以播放事件回调 |
onPlay |
开始播放事件回调 |
onPause |
暂停播放事件回调 |
onStop |
停止播放事件回调 |
onEnded |
播放结束事件回调，开启 loop 模式后无法收到 |
onTimeUpdate |
播放进度更新事件回调，只在 play 过程中才会收到，其他状态均收不到 |
onError |
播放错误事件回调 |
onSeeking |
跳转事件回调 |
onSeeked |
跳转完成事件回调 |
