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)
})