Version: 3.0.0-beta.5

Taro.createInnerAudioContext()

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

使用方式同 wx.createInnerAudioContext

返回值

object InnerAudioContext

PropertyTypeDefaultDescription
src
string
音频资源的地址,用于直接播放。
[startTime]
number
0
开始播放的位置(单位:s),默认为 0
[autoplay]
boolean
false
是否自动开始播放,默认为 false
[loop]
boolean
false
是否循环播放,默认为 false
[obeyMuteSwitch]
boolean
true
是否遵循系统静音开关,默认为 true。当此参数为 false 时,即使用户打开了静音开关,也能继续发出声音。
[volume]
number
1
音量。范围 0~1。默认为 1
duration
number
当前音频的长度(单位 s)。只有在当前有合法的 src 时返回(只读)
currentTime
number
当前音频的播放位置(单位 s)。只有在当前有合法的 src 时返回,时间保留小数点后 6 位(只读)
paused
boolean
当前是是否暂停或停止状态(只读)
buffered
number
音频缓冲的时间点,仅保证当前播放时间点到此时间点内容已缓冲(只读)
play
function
播放
pause
function
暂停。暂停后的音频再播放会从暂停处开始播放
stop
function
停止。停止后的音频再播放会从头开始播放。
seek
function
跳转到指定位置
destroy
function
销毁当前实例
offCanplay
function
取消监听音频进入可以播放状态的事件
offEnded
function
取消监听音频自然播放至结束的事件
offError
function
取消监听音频播放错误事件
offPause
function
取消监听音频暂停事件
offPlay
function
取消监听音频播放事件
offSeeked
function
取消监听音频完成跳转操作的事件
offSeeking
function
取消监听音频进行跳转操作的事件
offStop
function
取消监听音频停止事件
offTimeUpdate
function
取消监听音频播放进度更新事件
offWaiting
function
取消监听音频加载中事件
onCanplay
function
监听音频进入可以播放状态的事件。但不保证后面可以流畅播放
onEnded
function
监听音频自然播放至结束的事件
onError
function
监听音频播放错误事件
onPause
function
监听音频暂停事件
onPlay
function
监听音频播放事件
onSeeked
function
监听音频完成跳转操作的事件
onSeeking
function
监听音频进行跳转操作的事件
onStop
function
监听音频停止事件
onTimeUpdate
function
监听音频播放进度更新事件
onWaiting
function
监听音频加载中事件。当音频因为数据不足,需要停下来加载时会触发

示例代码

import Taro from '@tarojs/taro'
const innerAudioContext = Taro.createInnerAudioContext()

API支持度

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