框架与生命周期

调用代码

bricks引擎代码包含原生以及js层部分，旧版本开发者引用protocol.js来进行引擎js层接口的引用。新的开发者推荐使用qqPlayCore.js文件进行引用。单独引用protocol.js的方法也可以正常使用。

protocol.js为qqPlayCore.js的子集，除此外qqPlayCore.js还包含webscoket.js、Game.js等文件。

旧

BK.Script.loadlib('GameRes://script/core/net/protocol.js');

新(推荐)

BK.Script.loadlib('GameRes://qqPlayCore.js');

游戏配置

游戏包中必须含有gameConfig.json文件，用于进行游戏横竖屏、H5游戏url等整体配置。json内容如下例

例子

{
    "viewMode":2,
    "enterUrl":""
}

UI处理

统一框架UI有横屏&竖屏模式，需要开发者如下处理

• 7.5.8及以上版本，去掉游戏自己的关闭&缩小按钮，并根据统一的关闭缩小按钮的位置对游戏UI做相应处理

游戏事件以及生命周期

开发者使用BK.Game类可以后可以监听整体游戏生命流程。

BK.Game中的游戏内事件

onLoad

程序启动事件。游戏脚本加载完成后，进到此处

onMinmize

最小化事件，用户点击"收起游戏"

onClose

游戏关闭事件。用户点击右上角"关闭"图标，关闭游戏

开发者需处理销毁动作：上报用户成绩

onEnterbackground

退后台事件。用户按home键将手Q退至后台。

onEnterforeground

回到前台事件。手Q进程从后台回到前台。

onShare

分享事件。用户点击 “分享游戏”后触发。

手Q 7.6.5 后支持分享多渠道，开发者可自定义分享的数据
多渠道分享指 开发者可以通过返回特定类型的数据，达到自定义分享数据的效果 通过返回带有特定字段的数据

本分享与BK.QQ.Share相同，具体查看此处

分享成功/失败后，触发onShareComplete函数

onShareComplete

分享结果事件。返回分享结果。

onNetworkChange

网络环境切换事件。网络环境进行切换时会触发本事件

具体state的取值标识不同的切换情况。取值如下

onException

全局js异常/错误

代码实例：Res/script/demo/GameDemo.js(需bitbucket权限)

游戏呼起入口

在手Q中，游戏可能会在不同的入口中被呼起，开发者通过GameStatusInfo.src 参数处理用户打开游戏时体验。

大多数情况情况直接打开游戏大厅即可，在少数情况需特殊处理(聊天界面消息)</font>

实例代码如下

var SRC_AIO_BUBBLE_NORMAL = 200, //聊天窗游戏消息
var SRC_AIO_BUBBLE_SHARE = 201, //分享消息
var src = GameStatusInfo.src;
//聊天窗游戏消息
if (src == 200 /* SRC_AIO_BUBBLE_NORMAL */) {
    //
    var room = new BK.Room();
    var roomId = GameStatusInfo.roomId;
    var gameId = GameStatusInfo.gameId;
    var openId = GameStatusInfo.openId;
    //从聊天入口进入游戏，优先加入房间，如加入房间失败，则跳转至游戏大厅
    room.queryAndJoinRoom(gameId, roomId, openId, function (statusCode, room) {
        if (statusCode == 0) {
            //正常加入房间
        }
        else {
            //跳转至游戏大厅
        }
    };
}
//聊天面板中的大厅与 动态-玩一玩入口的 可以统一进入游戏主页
else {
    //加载游戏主页
}

GameStatusInfo.src 其他取值

原文: https://hudong.qq.com/docs/engine/engine/native/framework/intro.html