# uni.createInnerAudioContext()

创建并返回内部 audio 上下文 innerAudioContext 对象。

平台差异说明

App H5 微信小程序 支付宝小程序 百度小程序 抖音小程序、飞书小程序 QQ小程序 快手小程序 京东小程序
1.23.4+

HarmonyOS Next 兼容性

HarmonyOS Next
HBuilderX 4.25

innerAudioContext 对象的属性列表

属性 类型 说明 只读 平台差异说明
src String 音频的数据链接,用于直接播放。 微信小程序不支持本地路径
startTime Number 开始播放的位置(单位:s),默认 0
autoplay Boolean 是否自动开始播放,默认 false H5端部分浏览器不支持
loop Boolean 是否循环播放,默认 false
obeyMuteSwitch Boolean 是否遵循系统静音开关,当此参数为 false 时,即使用户打开了静音开关,也能继续发出声音,默认值 true 微信小程序、百度小程序、抖音小程序、飞书小程序、京东小程序、快手小程序(仅在 iOS 上生效)
duration Number 当前音频的长度(单位:s),只有在当前有合法的 src 时返回,需要在onCanplay中获取
currentTime Number 当前音频的播放位置(单位:s),只有在当前有合法的 src 时返回,时间不取整,保留小数点后 6 位
paused Boolean 当前是是否暂停或停止状态,true 表示暂停或停止,false 表示正在播放
buffered Number 音频缓冲的时间点,仅保证当前播放时间点到此时间点内容已缓冲。
volume Number 音量。范围 0~1。
sessionCategory String 设置音频播放模式,可取值:"ambient" - 不中止其他声音播放,不能后台播放,静音后无声音; "soloAmbient" - 中止其他声音播放,不能后台播放,静音后无声音; "playback" - 中止其他声音,可以后台播放,静音后有声音。 默认值为"playback"。 App 3.3.7+
playbackRate Number 播放的倍率。可取值:0.5/0.8/1.0/1.25/1.5/2.0,默认值为1.0 App 3.4.5+(Android 需要 6 及以上版本)、微信小程序 2.11.0、支付宝小程序、抖音小程序 2.33.0+、快手小程序、百度小程序 3.120.2+

innerAudioContext 对象的方法列表

方法 参数 说明 平台差异说明
play 播放(H5端部分浏览器需在用户交互时进行)
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 操作事件
offCanplay callback 取消监听 onCanplay 事件 微信小程序1.9.0+,支付宝小程序,抖音小程序、百度小程序
offPlay callback 取消监听 onPlay 事件 微信小程序1.9.0+,支付宝小程序,抖音小程序、百度小程序
offPause callback 取消监听 onPause 事件 微信小程序1.9.0+,支付宝小程序,抖音小程序、百度小程序
offStop callback 取消监听 onStop 事件 微信小程序1.9.0+,支付宝小程序,抖音小程序、百度小程序
offEnded callback 取消监听 onEnded 事件 微信小程序1.9.0+,支付宝小程序,抖音小程序、百度小程序
offTimeUpdate callback 取消监听 onTimeUpdate 事件 微信小程序1.9.0+,支付宝小程序,抖音小程序、百度小程序
offError callback 取消监听 onError 事件 微信小程序1.9.0+,支付宝小程序,抖音小程序、百度小程序
offWaiting callback 取消监听 onWaiting 事件 微信小程序1.9.0+,支付宝小程序,抖音小程序、百度小程序
offSeeking callback 取消监听 onSeeking 事件 微信小程序1.9.0+,支付宝小程序,抖音小程序、百度小程序
offSeeked callback 取消监听 onSeeked 事件 微信小程序1.9.0+,支付宝小程序,抖音小程序、百度小程序

errCode 说明

errCode 说明
10001 系统错误
10002 网络错误
10003 文件错误
10004 格式错误
-1 未知错误

支持格式

格式 iOS Android
flac x
m4a
ogg x
ape x
amr x
wma x
wav
mp3
mp4 x
aac
aiff x
caf x

tips

  • ape 格式的支持取决于 rom 厂商,在App移动端使用uni.createInnerAudioContext()不涉及专利授权问题,因为没有单独使用三方解码器

示例

const innerAudioContext = uni.createInnerAudioContext();
innerAudioContext.autoplay = true;
innerAudioContext.src = 'https://web-ext-storage.dcloud.net.cn/uni-app/ForElise.mp3';
innerAudioContext.onPlay(() => {
  console.log('开始播放');
});
innerAudioContext.onError((res) => {
  console.log(res.errMsg);
  console.log(res.errCode);
});


**当出现-99错误时** 可以按照下面思路进行排查:

```javascript
// 多次会调用播放新的文件时,提前销毁实例,可避免-99错误
if (innerAudioContext) {
  try {
    innerAudioContext.pause();
    innerAudioContext.destroy()
    innerAudioContext = null
  } catch (e) {
    //TODO handle the exception
  }
}

tips

  • 如需音频的倍速播放,可通过video的倍速播放替代实现。插件市场有封装好的插件音频倍速播放
  • 如果需要带ui的音频播放器样式,可以在插件市场搜索相关插件
  • Android 4.1 及更高版本对 PCM/WAVE 支持范围是 8 位和 16 位线性 PCM(比特率最高可达到硬件上限)。以 8000、16000 和 44100 Hz 录制原始 PCM 所需的采样率。