InnerAudioContext 概述

更新时间 2024-07-24 02:58:49
收藏
我的收藏
通过 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​
暂停播放​
1.0.0​
stop
停止播放​
1.0.0​
seek
跳转到指定位置播放​
1.0.0​
销毁当前实例。销毁后该实例将不存在,如需播放需要再次创建​
1.0.0​
监听音频进入可以播放状态,但不保证后面可以流畅播放​
1.0.0​
监听音频播放事件​
1.0.0​
监听音频暂停事件​
1.0.0​
监听音频停止播放事件​
1.0.0​
监听自然播放结束事件​
1.0.0​
监听音频进度更新事件​
1.0.0​
监听音频播放出错事件​
1.0.0​
监听音频加载中事件,当音频因为数据不足,需要停下来加载时会触发​
1.0.0​
监听音频开始进行 seek 操作的事件​
1.0.0​
监听音频完成 seek 操作的事件​
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 监听的事件​
1.0.0​
取消 onSeeked 监听的事件​
1.0.0​

Bug & Tip​