search
开发文档
开发文档/小游戏开发/API/基础/应用级事件
应用级事件更新时间:2025-12-24 18:13:05

基础信息说明

功能概述:监听与处理小游戏运行时的全局错误和音频播放被系统中断的事件。

项目说明
版本要求
前提条件
使用限制
相关教程

方法说明

全局错误

方法名签名同步/异步说明
onErrorqg.onError(Function callback): void同步注册,回调异步触发监听全局运行时错误
offErrorqg.offError(Function callback): void同步解绑取消 onError 绑定的回调

音频错误

方法名签名同步/异步说明
onAudioInterruptionBeginqg.onAudioInterruptionBegin(Function callback): void同步注册,回调异步触发音频被系统占用而中断开始
offAudioInterruptionBeginqg.offAudioInterruptionBegin(Function callback): void同步解绑取消 onAudioInterruptionBegin 绑定的回调
onAudioInterruptionEndqg.onAudioInterruptionEnd(Function callback): void同步注册,回调异步触发音频中断结束(可重新播放)
offAudioInterruptionEndqg.offAudioInterruptionEnd(Function callback): void同步解绑取消 onAudioInterruptionEnd 绑定的回调

参数说明

qg.onError(Function callback)

属性名类型必填说明
callbackFunction(String|Object error)全局错误事件的监听函数

回调参数常见结构

字段类型说明
messageString错误信息
stackString错误堆栈信息

qg.offError(Function callback)

属性名类型默认值(如有)必填说明
callbackFunction-需传入与 onError 注册时相同的函数引用;空参不会清除全部

qg.onAudioInterruptionBegin(Function callback)

属性名类型默认值(如有)必填说明
callbackFunction-音频因为受到系统占用而被中断开始事件的监听函数

触发场景:闹钟、电话、FaceTime 通话、微信语音聊天、微信视频聊天等系统占用音频时。

qg.offAudioInterruptionBegin(Function callback)

属性名类型默认值(如有)必填说明
callbackFunction-需传入与 onAudioInterruptionBegin 注册时相同的函数引用;空参不会清除全部

qg.onAudioInterruptionEnd(Function callback)

属性名类型默认值(如有)必填说明
callbackFunction-音频中断结束时触发;收到该事件后才可重新播放音频

qg.offAudioInterruptionEnd(Function callback)

属性名类型默认值(如有)必填说明
callbackFunction-需传入与 onAudioInterruptionEnd 注册时相同的函数引用;空参不会清除全部

回调结果说明

回调/事件触发时机回调参数说明
onError 事件小游戏运行时抛出错误error:错误信息或对象(常见含 message、stack)-
onAudioInterruptionBegin 事件系统占用导致音频被中断info:底层透传中断信息收到后游戏内音频被暂停
onAudioInterruptionEnd 事件音频中断结束info:底层透传结束信息收到后音频可再次播放

示例代码

const errorListener = function(res) {
console.log('occur exception:', res);
};

qg.onError(errorListener);
qg.offError(errorListener); // 需传入与监听时同一个的函数对象

const audioItpEndListener = function() {
console.log('audio interruption end!');
};

qg.onAudioInterruptionEnd(audioItpEndListener);
qg.offAudioInterruptionEnd(audioItpEndListener); // 需传入与监听时同一个的函数对象

const audioItpBeginListener = function() {
console.log('audio interruption begin!');
};

qg.onAudioInterruptionBegin(audioItpBeginListener);
qg.offAudioInterruptionBegin(audioItpBeginListener); // 需传入与监听时同一个的函数对象

注意事项

  • 取消监听需传入同一函数引用
上一篇:定时器
下一篇:性能
文档内容是否有帮助?
有帮助
无帮助