文档管理中心
API参考快游戏快游戏系统系统事件

系统事件

说明

从1078版本开始,接口前缀由hbs调整为qg,原hbs仍支持。

接口定义

展开

接口

描述

qg.onAudioInterruptionBegin(function callback)

监听音频因为受到系统占用而被中断开始,以下场景将触发此事件:闹钟、电话、FaceTime 通话。此事件触发后,游戏内所有音频会暂停。

qg.offAudioInterruptionBegin(function callback)

取消监听音频因为受到系统占用而被中断开始。

qg.onAudioInterruptionEnd(function callback)

监听音频中断结束,在收到onAudioInterruptionBegin事件之后,游戏内所有音频会暂停,收到此事件之后才可再次成功播放。

qg.offAudioInterruptionEnd(function callback)

取消监听音频中断结束。

qg.onError(function callback)

监听全局错误事件。

qg.offError(function callback)

取消监听全局错误事件。

qg.onAudioInterruptionBegin(function callback)

  • 描述

    监听音频因为受到系统占用而被中断开始,以下场景将触发此事件:闹钟、电话、FaceTime 通话。此事件触发后,游戏内所有音频会暂停。

  • 参数
    展开

    参数

    类型

    必填(M)/选填(O)

    说明

    callback

    function

    M

    音频因为受到系统占用而被中断开始事件的回调函数。

  • 示例代码
    收起
    自动换行
    深色代码主题
    复制
    1. qg.onAudioInterruptionBegin(
    2. () => {console.log("onAudioInterruptionBegin");}
    3. );

qg.offAudioInterruptionBegin(function callback)

  • 描述

    取消监听音频因为受到系统占用而被中断开始。

  • 参数
    展开

    参数

    类型

    必填(M)/选填(O)

    说明

    callback

    function

    M

    取消监听事件的回调函数。

  • 示例代码
    收起
    自动换行
    深色代码主题
    复制
    1. qg.offAudioInterruptionBegin(
    2. () => {console.log("offAudioInterruptionBegin");}
    3. );

qg.onAudioInterruptionEnd(function callback)

  • 描述

    监听音频中断结束,在收到 onAudioInterruptionBegin 事件之后,游戏内所有音频会暂停,收到此事件之后才可再次成功播放。

  • 参数
    展开

    参数

    类型

    必填(M)/选填(O)

    说明

    callback

    function

    M

    监听音频中断结束事件的回调函数。

  • 示例代码
    收起
    自动换行
    深色代码主题
    复制
    1. qg.onAudioInterruptionEnd(
    2. () => {console.log("onAudioInterruptionEnd");}
    3. );

qg.offAudioInterruptionEnd(function callback)

  • 描述

    取消监听音频中断结束。

  • 参数
    展开

    参数

    类型

    必填(M)/选填(O)

    说明

    callback

    function

    M

    取消监听音频中断结束事件的回调函数。

  • 示例代码
    收起
    自动换行
    深色代码主题
    复制
    1. qg.offAudioInterruptionEnd(
    2. () => {console.log("offAudioInterruptionEnd");}
    3. );

qg.onError(function callback)

  • 描述

    监听全局错误事件。

  • 参数
    展开

    参数

    类型

    必填(M)/选填(O)

    说明

    callback

    function

    M

    全局错误事件的回调函数,请参见callback回调函数参数

    • callback回调函数参数
      展开

      参数

      类型

      说明

      message

      string

      包含错误位置、错误信息、错误调用堆栈等。

  • 示例代码
    收起
    自动换行
    深色代码主题
    复制
    1. qg.onError(
    2. (res) => {console.log("onError message = " + res.message);}
    3. );

qg.offError(function callback)

  • 描述

    取消监听全局错误事件。

  • 参数
    展开

    参数

    类型

    必填(M)/选填(O)

    说明

    callback

    function

    M

    取消监听事件的回调函数。

  • 示例代码
    收起
    自动换行
    深色代码主题
    复制
    1. qg.offError(
    2. () => {console.log("offError");}
    3. );
在 API参考 中进行搜索
请输入您想要搜索的关键词