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

移除音频完成跳转操作的事件的监听函数

# 支持格式

# 示例代码

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