# InnerAudioContext
InnerAudioContext 实例,可通过 wx.createInnerAudioContext 接口获取实例。注意,音频播放过程中,可能被系统中断,可通过 wx.onAudioInterruptionBegin、wx.onAudioInterruptionEnd事件来处理这种情况。
# 属性
# string src
音频资源的地址,用于直接播放。2.2.3 开始支持云文件ID
# number startTime
开始播放的位置(单位:s),默认为 0
# boolean autoplay
是否自动开始播放,默认为 false
# boolean loop
是否循环播放,默认为 false
# boolean obeyMuteSwitch
是否遵循系统静音开关,默认为 true
。当此参数为 false
时,即使用户打开了静音开关,也能继续发出声音。从 2.3.0 版本开始此参数不生效,使用 wx.setInnerAudioOption 接口统一设置。
# number volume
基础库 1.9.90 开始支持,低版本需做兼容处理。
音量。范围 0~1。默认为 1
# number playbackRate
基础库 2.11.0 开始支持,低版本需做兼容处理。
播放速度。范围 0.5-2.0,默认为 1。(Android 需要 6 及以上版本)
# number duration
当前音频的长度(单位 s)。只有在当前有合法的 src 时返回(只读)
# number currentTime
当前音频的播放位置(单位 s)。只有在当前有合法的 src 时返回,时间保留小数点后 6 位(currentTime 属性在基础库 2.26.2 之前只读,基础库 2.26.2 开始可读可写,改变 currentTime 值等同于调用 seek)
# boolean paused
当前是是否暂停或停止状态(只读)
# number buffered
音频缓冲的时间点,仅保证当前播放时间点到此时间点内容已缓冲(只读)
# string referrerPolicy
基础库 2.13.0 开始支持,低版本需做兼容处理。
origin
: 发送完整的referrer; no-referrer
: 不发送。格式固定为 https://servicewechat.com/{appid}/{version}/page-frame.html
,其中 {appid} 为小程序的 appid,{version} 为小程序的版本号,版本号为 0 表示为开发版、体验版以及审核版本,版本号为 devtools 表示为开发者工具,其余为正式版本;
# 方法
# InnerAudioContext.play()
播放
# InnerAudioContext.pause()
暂停。暂停后的音频再播放会从暂停处开始播放
# InnerAudioContext.stop()
停止。停止后的音频再播放会从头开始播放。
# InnerAudioContext.seek(number position)
跳转到指定位置
# InnerAudioContext.destroy()
销毁当前实例
# InnerAudioContext.onCanplay(function listener)
监听音频进入可以播放状态的事件。但不保证后面可以流畅播放
# InnerAudioContext.offCanplay(function listener)
移除音频进入可以播放状态的事件的监听函数
# InnerAudioContext.onPlay(function listener)
监听音频播放事件
# InnerAudioContext.offPlay(function listener)
移除音频播放事件的监听函数
# InnerAudioContext.onPause(function listener)
监听音频暂停事件
# InnerAudioContext.offPause(function listener)
移除音频暂停事件的监听函数
# InnerAudioContext.onStop(function listener)
监听音频停止事件
# InnerAudioContext.offStop(function listener)
移除音频停止事件的监听函数
# InnerAudioContext.onEnded(function listener)
监听音频自然播放至结束的事件
# InnerAudioContext.offEnded(function listener)
移除音频自然播放至结束的事件的监听函数
# InnerAudioContext.onTimeUpdate(function listener)
监听音频播放进度更新事件
# InnerAudioContext.offTimeUpdate(function listener)
移除音频播放进度更新事件的监听函数
# InnerAudioContext.onError(function listener)
监听音频播放错误事件
# InnerAudioContext.offError(function listener)
移除音频播放错误事件的监听函数
# InnerAudioContext.onWaiting(function listener)
监听音频加载中事件。当音频因为数据不足,需要停下来加载时会触发
# InnerAudioContext.offWaiting(function listener)
移除音频加载中事件的监听函数
# InnerAudioContext.onSeeking(function listener)
监听音频进行跳转操作的事件
# InnerAudioContext.offSeeking(function listener)
移除音频进行跳转操作的事件的监听函数
# InnerAudioContext.onSeeked(function listener)
监听音频完成跳转操作的事件
# InnerAudioContext.offSeeked(function listener)
移除音频完成跳转操作的事件的监听函数
# 支持格式
格式 | iOS | Android |
---|---|---|
flac | x | √ |
m4a | √ | √ |
ogg | x | √ |
ape | x | √ |
amr | x | √ |
wma | x | √ |
wav | √ | √ |
mp3 | √ | √ |
mp4 | x | √ |
aac | √ | √ |
aiff | √ | x |
caf | √ | x |
# 示例代码
const innerAudioContext = wx.createInnerAudioContext()
innerAudioContext.autoplay = true
innerAudioContext.src = 'https://wx_test.mp3'
innerAudioContext.onPlay(() => {
console.log('开始播放')
})
innerAudioContext.onError((res) => {
console.log(res.errMsg)
console.log(res.errCode)
})