生命周期

qq.onShow

qq.onShow(function callback)

监听小游戏回到前台的事件

参数

function callback

小游戏回到前台的事件的回调函数

参数

Object res

属性类型说明
scenestring场景值
queryObject查询参数
shareTicketstringshareTicket
referrerInfoobject当场景为由从另一个小程序或公众号或App打开时，返回此字段

referrerInfo 的结构

属性类型说明
appIdstring来源小程序或公众号或App的 appId
extraDataobject来源小程序传过来的数据，scene=1037或1038时支持

qq.onHide

qq.onHide(function callback)

监听小游戏隐藏到后台事件。锁屏、按 HOME 键退到桌面、显示在聊天顶部等操作会触发此事件。

参数

function callback

小游戏隐藏到后台事件的回调函数

qq.offShow

qq.offShow(function callback)

取消监听小游戏回到前台的事件

参数

function callback

小游戏回到前台的事件的回调函数

.offHide

qq.offHide(function callback)

取消监听小游戏隐藏到后台事件

参数

function callback

小游戏隐藏到后台事件的回调函数

qq.getLaunchOptionsSync

Object qq.getLaunchOptionsSync()

获取小游戏启动时的参数。

返回值

Object

启动参数

属性类型说明
scenenumber启动小游戏的场景值
queryObject启动小游戏的 query 参数
shareTicketstringshareTicket，详见获取更多转发信息
referrerInfoobject来源信息。从另一个小程序、公众号或 App 进入小程序时返回。否则返回 {}。(参见后文注意)

referrerInfo 的结构

属性类型说明
appIdstring来源小程序、公众号或 App 的 appId
extraDataobject来源小程序传过来的数据，scene=1037或1038时支持

返回有效 referrerInfo 的场景

场景值场景appId含义
1020公众号 profile 页相关小程序列表来源公众号
1035公众号自定义菜单来源公众号
1036App 分享消息卡片来源App
1037小程序打开小程序来源小程序
1038从另一个小程序返回来源小程序
1043公众号模板消息来源公众号

注意

部分版本在无referrerInfo的时候会返回 undefined，建议使用 options.referrerInfo && options.referrerInfo.appId 进行判断。

qq.exitMiniProgram

qq.exitMiniProgram(Object object)

退出当前小游戏

参数

Object object
属性类型默认值必填说明
successfunction否接口调用成功的回调函数
failfunction否接口调用失败的回调函数
completefunction否接口调用结束的回调函数（调用成功、失败都会执行）

应用级事件

qq.onError

qq.onError(function callback)

监听全局错误事件

参数

function callback

全局错误事件的回调函数

参数

Object res

属性类型说明
messagestring错误
stackstring错误调用堆栈

qq.onAudioInterruptionEnd

qq.onAudioInterruptionEnd(function callback)

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

参数

function callback

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

qq.onAudioInterruptionBegin

qq.onAudioInterruptionBegin(function callback)

监听音频因为受到系统占用而被中断开始事件。以下场景会触发此事件：闹钟、电话、FaceTime 通话、QQ语音聊天、QQ视频聊天。此事件触发后，小程序内所有音频会暂停。

参数

function callback

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

qq.offError

qq.offError(function callback)

取消监听全局错误事件

参数

function callback

全局错误事件的回调函数

qq.offAudioInterruptionEnd

qq.offAudioInterruptionEnd(function callback)

取消监听音频中断结束事件

参数

function callback

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

qq.offAudioInterruptionBegin

qq.offAudioInterruptionBegin(function callback)

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

参数

function callback

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

触摸事件

qq.onTouchStart

qq.onTouchStart(function callback)

监听开始触摸事件

参数

function callback

开始触摸事件的回调函数

参数

Object res

属性类型说明
touchesArray.<Touch>当前所有触摸点的列表
changedTouchesArray.<Touch>触发此次事件的触摸点列表
timeStampnumber事件触发时的时间戳

qq.onTouchMove

qq.onTouchMove(function callback)

监听触点移动事件

参数

function callback

触点移动事件的回调函数

参数

Object res

属性类型说明
touchesArray.<Touch>当前所有触摸点的列表
changedTouchesArray.<Touch>触发此次事件的触摸点列表
timeStampnumber事件触发时的时间戳

qq.onTouchEnd

qq.onTouchEnd(function callback)

监听触摸结束事件

参数

function callback

触摸结束事件的回调函数

参数

Object res

属性类型说明
touchesArray.<Touch>当前所有触摸点的列表
changedTouchesArray.<Touch>触发此次事件的触摸点列表
timeStampnumber事件触发时的时间戳

qq.onTouchCancel

qq.onTouchCancel(function callback)

监听触点失效事件

参数

function callback

触点失效事件的回调函数

参数

Object res

属性类型说明
touchesArray.<Touch>当前所有触摸点的列表
changedTouchesArray.<Touch>触发此次事件的触摸点列表
timeStampnumber事件触发时的时间戳

qq.offTouchStart

qq.offTouchStart(function callback)

取消监听开始触摸事件

参数

function callback

开始触摸事件的回调函数

qq.offTouchMove

qq.offTouchMove(function callback)

取消监听触点移动事件

参数

function callback

触点移动事件的回调函数

qq.offTouchEnd

qq.offTouchEnd(function callback)

取消监听触摸结束事件

参数

function callback

触摸结束事件的回调函数

qq.offTouchCancel

qq.offTouchCancel(function callback)

取消监听触点失效事件

参数

function callback

触点失效事件的回调函数

Touch

在触控设备上的触摸点。通常是指手指或者触控笔在触屏设备或者触摸板上的操作。

属性

number identifier

Touch 对象的唯一标识符，只读属性。一次触摸动作(我们值的是手指的触摸)在平面上移动的整个过程中, 该标识符不变。可以根据它来判断跟踪的是否是同一次触摸过程。

number screenX

触点相对于屏幕左边沿的 X 坐标。

number screenY

触点相对于屏幕上边沿的 Y 坐标。