# InnerAudioContext
InnerAudioContext 实例,可通过 ks.createInnerAudioContext 接口获取实例。
# 属性
# string src
音频资源的地址,用于直接播放。
# number startTime
开始播放的位置(单位:s),默认为 0
# boolean autoplay
是否自动开始播放,默认为 false
# boolean loop
是否循环播放,默认为 false
# boolean obeyMuteSwitch
是否遵循系统静音开关,默认为 true。当此参数为 false 时,即使用户打开了静音开关,也能继续发出声音。
# number volume
音量。范围 0~1。默认为 1
# number playbackRate
播放速度。范围 0.5-2.0,默认为 1。(Android 需要 6 及以上版本)
# number duration
当前音频的长度(单位 s)。只有在当前有合法的 src 时返回(只读)
# number currentTime
当前音频的播放位置(单位 s)。只有在当前有合法的 src 时返回,时间保留小数点后 6 位(只读)
# boolean paused
当前是是否暂停或停止状态(只读)
# number buffered
音频缓冲的时间点,仅保证当前播放时间点到此时间点内容已缓冲(只读)
# 方法
# InnerAudioContext.play
播放
# InnerAudioContext.pause
暂停。暂停后的音频再播放会从暂停处开始播放
# InnerAudioContext.stop
停止。停止后的音频再播放会从头开始播放。
# InnerAudioContext.seek
跳转到指定位置
# InnerAudioContext.destroy
销毁当前实例
# InnerAudioContext.onCanplay
监听音频进入可以播放状态的事件。但不保证后面可以流畅播放
# InnerAudioContext.offCanplay
取消监听音频进入可以播放状态的事件
# InnerAudioContext.onPlay
监听音频播放事件
# InnerAudioContext.offPlay
取消监听音频播放事件
# InnerAudioContext.onPause
监听音频暂停事件
# InnerAudioContext.offPause
取消监听音频暂停事件
# InnerAudioContext.onStop
监听音频停止事件
# InnerAudioContext.offStop
取消监听音频停止事件
# InnerAudioContext.onEnded
监听音频自然播放至结束的事件
# InnerAudioContext.offEnded
取消监听音频自然播放至结束的事件
# InnerAudioContext.onTimeUpdate
监听音频播放进度更新事件
# InnerAudioContext.offTimeUpdate
取消监听音频播放进度更新事件
# InnerAudioContext.onError
监听音频播放错误事件
# InnerAudioContext.offError
取消监听音频播放错误事件
# 支持格式
格式 | iOS | Android |
---|---|---|
wav | √ | √ |
mp3 | √ | √ |
# 示例代码
const innerAudioContext = ks.createInnerAudioContext()
innerAudioContext.autoplay = true
innerAudioContext.src = 'your_audio_src'//音频资源的地址
innerAudioContext.onPlay(() => {
console.log('开始播放')
})
innerAudioContext.onError((res) => {
console.log(res.errMsg)
console.log(res.errCode)
})