QQ游戏开放平台

欢迎来到QQ游戏开放平台 登录| 管理中心 | 开发者论坛

PC大厅客户端游戏接入广告

目录


一、命令行参数

showAD=1

大厅拉起游戏命令行参数含有showAD表示大厅支持播放广告,如果没有该参数说明是大厅旧版本不支持播放广告。如果是大厅旧版本不支持播放广告,游戏可以选择


1、游戏侧做好版本兼容,不支持播放广告的版本不展示广告入口

2、大厅侧配置游戏限制大厅升级到新版本,玩家只能升级到新版本才能玩该游戏


二、websocket接口

游戏 to 大厅

项目
命令
说明
是否必须
游戏退出
{"cmd":"game_exit"}
游戏退出前通知大厅
必须
打开页面

{

"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的主窗口名,字符串类型;如果已传入句柄,此参数可以不传

如果不传大厅会判断屏幕的最上层窗口

可选

大厅to游戏

项目
命令
说明
是否必须
老板键

{"cmd":"boss_key","show":0}

游戏侧跟进参数show显示或隐藏游戏界面。show:0隐藏,非0显示

必须
前置显示
{"cmd":"bring_to_top"}
游戏收到该消息后,前置显示界面
必须
页面关闭
{"cmd":"web_close"}
open_web请求的页面关闭时,通知游戏。
可选
支付关闭
{"cmd":"pay_close"}
支付页关闭时,通知游戏
可选

购买蓝钻页面关闭

{"cmd":"buy_vip_close"}

购买蓝钻页面关闭,游戏需刷新蓝钻信息。参考:/v3/user/blue_vip_info

可选
广告关闭
{"cmd":"ad_close", code:"x"}

广告关闭的回调

code == -1 未加载广告或者加载错误后关闭

code == 0 未播放到指定时长关闭,不用发奖励

code== 1  播放到指定时长后关闭,可以发奖励

调用广告接口必须




联系我们 向上
回到顶部