
wx.createInnerAudioContext()
基础库 1.6.0 开始支持,低版本需做兼容处理
创建并返回内部 audio 上下文 innerAudioContext 对象。本接口是 wx.createAudioContext 升级版。
innerAudioContext
innerAudioContext 对象的属性列表:
| 属性 | 类型 | 说明 | 只读 |
|---|---|---|---|
| src | String | 音频的数据链接,用于直接播放。 | 否 |
| startTime | Number | 开始播放的位置(单位:s),默认 0 | 否 |
| autoplay | Boolean | 是否自动开始播放,默认 false | 否 |
| loop | Boolean | 是否循环播放,默认 false | 否 |
| obeyMuteSwitch | Boolean | 是否遵循系统静音开关,当此参数为 false 时,即使用户打开了静音开关,也能继续发出声音,默认值 true | 否 |
| duration | Number | 当前音频的长度(单位:s),只有在当前有合法的 src 时返回 | 是 |
| currentTime | Number | 当前音频的播放位置(单位:s),只有在当前有合法的 src 时返回,时间不取整,保留小数点后 6 位 | 是 |
| paused | Boolean | 当前是是否暂停或停止状态,true 表示暂停或停止,false 表示正在播放 | 是 |
| buffered | Number | 音频缓冲的时间点,仅保证当前播放时间点到此时间点内容已缓冲。 | 是 |
innerAudioContext 对象的方法列表:
| 方法 | 参数 | 说明 |
|---|---|---|
| play | 无 | 播放 |
| pause | 无 | 暂停 |
| stop | 无 | 停止 |
| seek | position | 跳转到指定位置,单位 s |
| destroy | 无 | 销毁当前实例 |
| onCanplay | callback | 音频进入可以播放状态,但不保证后面可以流畅播放 |
| onPlay | callback | 音频播放事件 |
| onPause | callback | 音频暂停事件 |
| onStop | callback | 音频停止事件 |
| onEnded | callback | 音频自然播放结束事件 |
| onTimeUpdate | callback | 音频播放进度更新事件 |
| onError | callback | 音频播放错误事件 |
| onWaiting | callback | 音频加载中事件,当音频因为数据不足,需要停下来加载时会触发 |
| onSeeking | callback | 音频进行 seek 操作事件 |
| onSeeked | callback | 音频完成 seek 操作事件 |
errCode 说明
| errCode | 说明 |
|---|---|
| 10001 | 系统错误 |
| 10002 | 网络错误 |
| 10003 | 文件错误 |
| 10004 | 格式错误 |
| -1 | 未知错误 |
const innerAudioContext = wx.createInnerAudioContext()
innerAudioContext.autoplay = true
innerAudioContext.src = 'http://my.mcto.com.cn/images/cd.mp3'
innerAudioContext.onPlay(() => {
console.log('开始播放')
})
innerAudioContext.onError((res) => {
console.log(res.errMsg)
console.log(res.errCode)
})歌曲在背播放,并没有出现任何东西
Bug & Tip
tip:一个小程序内最多只能存在 5 个 innerAudio 实例**