开发
API

InnerAudioContext

InnerAudioContext 实例,可通过 tt.createInnerAudioContext 接口获取实例,通过它能够操作音频播放。

属性

属性名类型默认值必填说明最低支持版本
srcstring音频资源地址,仅支持临时路径(如通过下载到本地的音频地址)、网络地址(该地址的域名必须在小程序开发者平台 request 域名白名单中配置)1.0.0
autoplaybooleanfalse是否自动播放1.0.0
loopbooleanfalse是否自动循环1.0.0
obeyMuteSwitchbooleantrue是否遵循系统静音开关,当此参数为 false 时,即使用户打开了静音开关,也能继续发出声音1.0.0
durationnumber当前音频总时长(单位 s),只有在当前有合法的 src 时返回,只读1.0.0
currentTimenumber当前音频进度(单位 s),只有在当前有合法的 src 时返回,只读1.0.0
pausedboolean当前音频是否处于暂停状态,只读1.0.0
bufferednumber当前音频已缓冲部分,单位百分比,仅保证当前播放时间点到此时间点内容已缓冲,只读1.0.0
volumenumber当前音量,范围 0 ~ 1,只读1.0.0

方法

InnerAudioContext.play()

播放。

InnerAudioContext.pause()

暂停播放。

InnerAudioContext.stop()

停止播放。

InnerAudioContext.seek(number position)

跳转到 position 指定的位置播放,数据格式为 number,单位为秒(s)。

InnerAudioContext.destory()

销毁当前 InnerAudioContext 实例。

InnerAudioContext.onCanplay(function callback)

音频进入可以播放状态,但不保证后面可以流畅播放。

InnerAudioContext.offCanplay(function callback)

取消监听音频进入可以播放状态(Canplay)的事件。

InnerAudioContext.onPlay(function callback)

监听音频播放事件。

InnerAudioContext.offPlay(function callback)

取消监听音频播放(Play)事件。

InnerAudioContext.onPause(function callback)

监听音频暂停事件。

InnerAudioContext.offPause(function callback)

取消监听音频暂停(Pause)事件。

InnerAudioContext.onStop(function callback)

监听音频停止事件。

InnerAudioContext.offStop(function callback)

取消监听音频停止(Stop)事件

InnerAudioContext.onEnded(function callback)

监听音频自然播放结束事件。

InnerAudioContext.offEnded(function callback)

取消监听音频自然播放至结束(Ended)的事件。

InnerAudioContext.onTimeUpdate(function callback)

监听音频播放进度更新事件。

InnerAudioContext.offTimeUpdate(function callback)

取消监听音频播放进度更新(TimeUpdate)事件。

InnerAudioContext.onError(function callback)

监听音频播放错误事件。

InnerAudioContext.offError(function callback)

取消监听音频播放错误(Error)事件。

InnerAudioContext.onWaiting(function callback)

监听音频加载中的事件,当音频因为数据不足,需要停下来加载时会触发。

InnerAudioContext.offWaiting(function callback)

取消监听音频加载中(Waiting)事件。

InnerAudioContext.onSeeking(function callback)

监听音频进行跳转操作的事件。

InnerAudioContext.offSeeking(function callback)

取消监听音频进行跳转操作(Seeking)的事件。

InnerAudioContext.onSeeked(function callback)

监听音频完成跳转操作(seek)的事件。

InnerAudioContext.offSeeked(function callback)

取消监听音频完成跳转操作(Seeked)的事件。

点击纠错
评价此篇文档