Skip to main content
Version: 1.x

Taro.createInnerAudioContext()

创建内部 audio 上下文 InnerAudioContext 对象。

使用方式同 wx.createInnerAudioContext

返回值

object InnerAudioContext

PropertyTypeDefaultDescription
srcstring音频资源的地址,用于直接播放。
[startTime]number0开始播放的位置(单位:s),默认为 0
[autoplay]booleanfalse是否自动开始播放,默认为 false
[loop]booleanfalse是否循环播放,默认为 false
[obeyMuteSwitch]booleantrue是否遵循系统静音开关,默认为 true。当此参数为 false 时,即使用户打开了静音开关,也能继续发出声音。
[volume]number1音量。范围 0~1。默认为 1
durationnumber当前音频的长度(单位 s)。只有在当前有合法的 src 时返回(只读)
currentTimenumber当前音频的播放位置(单位 s)。只有在当前有合法的 src 时返回,时间保留小数点后 6 位(只读)
pausedboolean当前是是否暂停或停止状态(只读)
bufferednumber音频缓冲的时间点,仅保证当前播放时间点到此时间点内容已缓冲(只读)
playfunction播放
pausefunction暂停。暂停后的音频再播放会从暂停处开始播放
stopfunction停止。停止后的音频再播放会从头开始播放。
seekfunction跳转到指定位置
destroyfunction销毁当前实例
offCanplayfunction取消监听音频进入可以播放状态的事件
offEndedfunction取消监听音频自然播放至结束的事件
offErrorfunction取消监听音频播放错误事件
offPausefunction取消监听音频暂停事件
offPlayfunction取消监听音频播放事件
offSeekedfunction取消监听音频完成跳转操作的事件
offSeekingfunction取消监听音频进行跳转操作的事件
offStopfunction取消监听音频停止事件
offTimeUpdatefunction取消监听音频播放进度更新事件
offWaitingfunction取消监听音频加载中事件
onCanplayfunction监听音频进入可以播放状态的事件。但不保证后面可以流畅播放
onEndedfunction监听音频自然播放至结束的事件
onErrorfunction监听音频播放错误事件
onPausefunction监听音频暂停事件
onPlayfunction监听音频播放事件
onSeekedfunction监听音频完成跳转操作的事件
onSeekingfunction监听音频进行跳转操作的事件
onStopfunction监听音频停止事件
onTimeUpdatefunction监听音频播放进度更新事件
onWaitingfunction监听音频加载中事件。当音频因为数据不足,需要停下来加载时会触发

示例代码

import Taro from '@tarojs/taro'

const innerAudioContext = Taro.createInnerAudioContext()

API支持度

API微信小程序H5React Native支付宝小程序百度小程序
Taro.createInnerAudioContext✔️✔️