InnerAudioContext 概述

我的收藏

通过 tt.createInnerAudioContext 获取的实例，通过它能够操作音频播放。音频默认遵循系统静音开关，在系统静音情况下，若希望音频播放有声音，可通过 InnerAudioContext.obeyMuteSwitch 属性进行设置。

属性

属性名	类型	默认值	必填	说明	最低支持版本
src	string	''	是	音频资源地址，仅支持临时路径（如通过下载到本地的音频地址）、网络地址（该地址的域名必须在开发者平台 request 域名白名单中配置），只支持 mp3、wav、m4a、aac 格式。	1.0.0
startTime	number	0	否	开始播放的位置（单位：s）	1.0.0
autoplay	boolean	false	否	是否自动播放	1.0.0
loop	boolean	false	否	是否自动循环	1.0.0
obeyMuteSwitch	boolean	true	否	是否遵循系统静音开关，当此参数为 false 时，即使用户打开了静音开关，也能继续发出声音	1.0.0
volume	number	1	否	当前音量，范围 0 ～ 1	1.0.0
playbackRate	number	1	否	播放速度。范围 0.5 ～ 2.0，默认为 1	2.33.0

属性名	类型	说明	最低支持版本
duration	number	当前音频总时长（单位：s），只有在当前有合法的 src 时返回	1.0.0
currentTime	number	当前音频进度（单位：s），只有在当前有合法的 src 时返回	1.0.0
paused	boolean	当前音频是否处于暂停状态	1.0.0
buffered	number	当前音频已缓冲部分（单位：s），仅保证当前播放时间点到此时间点内容已缓冲，只读	1.0.0

方法名	说明	最低支持版本
play	播放音频	1.0.0
pause	暂停播放	1.0.0
stop	停止播放	1.0.0
seek	跳转到指定位置播放	1.0.0
destroy	销毁当前实例。销毁后该实例将不存在，如需播放需要再次创建	1.0.0
onCanplay	监听音频进入可以播放状态，但不保证后面可以流畅播放	1.0.0
onPlay	监听音频播放事件	1.0.0
onPause	监听音频暂停事件	1.0.0
onStop	监听音频停止播放事件	1.0.0
onEnded	监听自然播放结束事件	1.0.0
onTimeUpdate	监听音频进度更新事件	1.0.0
onError	监听音频播放出错事件	1.0.0
onWaiting	监听音频加载中事件，当音频因为数据不足，需要停下来加载时会触发	1.0.0
onSeeking	监听音频开始进行 seek 操作的事件	1.0.0
onSeeked	监听音频完成 seek 操作的事件	1.0.0
offCanplay	取消 onCanplay 监听的事件	1.0.0
offPlay	取消 onPlay 监听的事件	1.0.0
offPause	取消 onPause 监听的事件	1.0.0
offStop	取消 onStop 监听的事件	1.0.0
offEnded	取消 onEnded 监听的事件	1.0.0
offTimeUpdate	取消 onTimeUpdate 监听的事件	1.0.0
offError	取消 onError 监听的事件	1.0.0
offWaiting	取消 onWaiting 监听的事件	1.0.0
offSeeking	取消 onSeeking 监听的事件	1.0.0
offSeeked	取消 onSeeked 监听的事件	1.0.0

•

Tip：从基础库 3.16.0 开始，支持开发者按 url 和 domain 维度配置添加 referer 请求头的规则，具体见网络资源请求添加referer规则。