QQ游戏 开放平台

欢迎来到QQ游戏开放平台 管理中心 | 注册 | 开发者论坛
蓝钻接入API列表

4.7 GameAPI.GetCoupon

4.7.1 功能说明

在游戏内获取折扣券

4.7.2 调用说明

1.接口包含

页面必须包含QQGame开放平台提供的js库,才能调用各js接口,如下:
//qqgameplatcdn.qq.com/social_hall/js/jquery.js
//qqgameplatcdn.qq.com/social_hall/js/jquery.pm.js
//qqgameplatcdn.qq.com/social_hall/app_frame/qqgamelib.js
游戏方可以直接在页面头部加载上面的js库,如下图:

也可以为性能考虑,在需要调用js接口前,动态加载上面的js库,不做约束。

2.域名检查
首先保证应用所在的域名是app$appid.qqgameapp.com或s\d\d.app$appid.qqgameapp.com,或者为qqgame.app$appid.twsapp.com, $appid为开放平台部分配的应用接入id,\d代表任一0~9整数。 多区多服应用域名支持app$appid.openwebgame.qq.com

3.接入QQGame
APP接入页面均内嵌在开放平台接入页面中,Javascript API定义在父页面中,各APP通过回调函数满足定制需求,调用API前需要提供域名到QQGame平台,并在平台发布白名单后在大厅测试专区中,使用测试号码进行调试。

4.7.3 调用方式(参考FOR QQ)

GameAPI. GetCoupon.show(gaid, sandbox, close_cb);

参数 含义
gaid 分配给应用的id,如29137、100630595等。

不能填写qqgame侧分配的id,如10067、10079。

appid:详见名词解释
gaid:开平分配的游戏id
sandbox 是否是沙箱环境,目前该接口暂不提供测试环境,统一填0
close_cb 关闭对话框的回调函数(无参数)

4.7.4 范例

GameAPI.GetCoupon.show(
15499, // gaid
0, // sandbox
function() {alert('close!') // 回调函数
);