GameAPI.NewOpenGameVIPService
4.1.1功能说明
新版的弹出开通蓝钻的内嵌页,前端JS接口(推荐使用)
4.1.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库,不做约束。
首先保证应用所在的域名是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.调用接口前
请先向QQGame平台提供应用定义邀请字符串(不超过60中文字符)及应用邀请图片,通过审核后更新配置即可使用。
如:
欢迎进入xx世界。。。
并提供一张74*74链接图片URL(注:建议图片格式为png/jpg/gif)
Tips的图片,尺寸规格为80*90(注:图片格式为静态gif)
5.被邀请者接受邀请会启动游戏。游戏启动链接中会包含如下信息:
&invitor=OPENID&invkey=INVKEY¶m=GAMEPARA,其中:
invitor为邀请发起者的openid
Invkey为邀请验证字段,后续会提供api验证该invkey的正确性
param为应用自定义参数(长度上限256bytes)
4.1.3调用方式(参考FOR QQ)
GameAPI. NewOpenGameVIPService.show(appid,close_cb, aid, service_type, duration);
参数名称 | 含义 |
---|---|
appid | 分配给应用的id,如29137、100630595等 |
close_cb | 关闭对话框的回调函数(无参数) |
aid | 统计信息,在接入时由qqgame侧分配 |
service_type | 服务类型,取值如下: 1: 普通蓝钻,开通界面将不显示豪华蓝钻 2: 豪华蓝钻,开通界面将不显示普通蓝钻 3 同时显示 不传入此参数: 开通界面将显示普通蓝钻和豪华蓝钻选项 |
duration | 开通时长,取值范围为1 - 24,单位为月。 在设置了此参数后,开通界面将不能再手动更改开通时长,付费模式为“按月付费”,且不能手动更改。 不传入此参数,付费模式和开通时长均可手动修改。 |
4.1.4 范例
GameAPI.NewOpenGameVIPService.show(
10001,
function() {alert('close!');},
'myaid',
3,
5
);
或者
GameAPI.NewOpenGameVIPService.show(
10001,
function() {alert('close!');},
'myaid'
);
后面两个参数非比传。
10001,
function() {alert('close!');},
'myaid',
3,
5
);
或者
GameAPI.NewOpenGameVIPService.show(
10001,
function() {alert('close!');},
'myaid'
);
后面两个参数非比传。