qg.createInnerAudioContext

基础信息说明

功能概述：创建内部音频上下文 InnerAudioContext，用于播放、控制与监听音频状态

参数说明

无

返回值说明

同步方法：调用后立即返回InnerAudioContext 实例。

InnerAudioContext 属性（读写）

InnerAudioContext 属性（只读）

InnerAudioContext 方法

监听/取消监听事件方法

支持为同一事件挂多个监听并按需移除。

• 触发机制：所有事件均为异步，并在播放流程中触发。
• 命名与用法：事件以小写属性命名；推荐通过小驼峰订阅/取消方法（onX/offX）注册多个监听。
• 回调签名：(event?: Event) => void；除 onerror 外，一般不携带结构化数据。

错误码

监听音频播放错误事件 InnerAudioContext.onError(Function callback)会响应错误码，onError 回调参数通常为对象，并包含以下字段；具体值依运行环境实现。

callback参数Object

errCode 的合法值

示例代码

// 创建并播放音频（使用订阅/取消方法）
const audio = qg.createInnerAudioContext()
audio.src = 'http://music.163.com/song/media/outer/url?id=1293886117.mp3'

audio.onCanplay(() => {
  console.log('音频可播放')
  audio.play()
})

// 跳转到 3 秒
audio.seek(3)
// 暂停
audio.pause()
// 停止（下次从 startTime 处开始）
audio.stop()
// 销毁实例
audio.destroy()

audio.onTimeUpdate(() => {
  console.log('进度:', audio.currentTime.toFixed(2))
})

audio.onError((e) => {
  console.error('播放错误', e)
})

// 订阅/取消事件
function onUpdate({}) {
  console.log('订阅: 进度更新')
}
audio.onTimeUpdate(onUpdate)
// audio.offTimeUpdate(onUpdate)