一、命令行参数
showAD=1
大厅拉起游戏命令行参数含有showAD表示大厅支持播放广告,如果没有该参数说明是大厅旧版本不支持播放广告。如果是大厅旧版本不支持播放广告,游戏可以选择
1、游戏侧做好版本兼容,不支持播放广告的版本不展示广告入口
2、大厅侧配置游戏限制大厅升级到新版本,玩家只能升级到新版本才能玩该游戏
二、websocket接口
游戏 to 大厅
{
"cmd":"open_web",
"caption":"窗口标题",
"url":"https://qqgame.qq.com",
"width":1440,
"height":900
}
游戏请求大厅带登录态打开页面。
仅支持腾讯域的页面
{
"cmd":"pay",
"param":"xxxxx"
}
param请参考:
客户端游戏支付页接入中的购买商品-使用大厅提供的购买页部分
{
"cmd":"buy_vip",
"param":"xxxxx"
}
param请参考:
客户端游戏支付页接入中的开通蓝钻部分
窗口关闭后,会返回"vip_info"消息
{
"cmd":"open_ad",
"game_hwnd":xxxxx,
"wnd_name":"xxxxx"
}
game_hwnd为游戏传入的游戏UI主窗口句柄,类型为DWORD
wnd_name为游戏传入的游戏UI的主窗口名,字符串类型;如果已传入句柄,此参数可以不传
如果不传大厅会判断屏幕的最上层窗口
项目
命令
说明
是否必须
游戏退出
{"cmd":"game_exit"}
游戏退出前通知大厅
必须
打开页面
可选
打开支付
可选
购买蓝钻
可选
加载广告
可选
大厅to游戏
{"cmd":"boss_key","show":0}
游戏侧跟进参数show显示或隐藏游戏界面。show:0隐藏,非0显示
购买蓝钻页面关闭
购买蓝钻页面关闭,游戏需刷新蓝钻信息。参考:/v3/user/blue_vip_info
广告关闭的回调
code == -1 未加载广告或者加载错误后关闭
code == 0 未播放到指定时长关闭,不用发奖励
code== 1 播放到指定时长后关闭,可以发奖励
调用广告接口必须
项目
命令
说明
是否必须
老板键
必须
前置显示
{"cmd":"bring_to_top"}
游戏收到该消息后,前置显示界面
必须
页面关闭
{"cmd":"web_close"}
open_web请求的页面关闭时,通知游戏。
可选
支付关闭
{"cmd":"pay_close"}
支付页关闭时,通知游戏
可选
{"cmd":"buy_vip_close"}
可选
广告关闭
{"cmd":"ad_close", code:"x"}