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 |
referrerPolicy | string | 'no-referrer' | 否 | origin: 发送完整的 referrer; no-referrer: 不发送。格式固定为 https://tmaservice.developer.toutiao.com/{appid}/{version}/page-frame.html,其中 {appid} 为小程序的 appid,{version} 为小程序的版本号,版本号为 0 表示为开发版、体验版以及审核版本,版本号为 devtools 表示为开发者工具,其余为正式版本 | 2.33.0 |
只读属性
属性名 | 类型 | 说明 | 最低支持版本 |
---|---|---|---|
duration | number | 当前音频总时长(单位:s),只有在当前有合法的 src 时返回 | 1.0.0 |
currentTime | number | 当前音频进度(单位:s)),只有在当前有合法的 src 时返回 | 1.0.0 |
paused | boolean | 当前音频是否处于暂停状态 | 1.0.0 |
buffered | number | 当前音频已缓冲部分,单位百分比,仅保证当前播放时间点到此时间点内容已缓冲 | 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 | |
监听自然播放结束事件 | 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 |