QQ游戏开放平台

接入wiki索引

GameAPI.NewGameVIPActionEx

4.1.1功能说明

新版的通过活动开通蓝钻后，使用此接口来领取相应的活动礼包，和GameAPI.NewGameVIPAction这个接口相比，内部实现不同，但是功能相同。

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库，不做约束。

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.调用接口前
请先向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. NewGameVIPActionEx.show(appid, mp_id, token, zoneid, openid, version, close_cb, service_type, duration, open_gamevip_mode);

参数名称	含义
appid	分配给应用的id，如29137、100630595等
mp_id	活动号(需事先在腾讯营销平台配置相应的活动)
token	支付交易标识(在活动中进行支付时取得的token，详见支付类API：v3/pay/get_token )
zoneid	游戏大区id
openid	开放平台用户的唯一标记
version	协议版本号，目前取值为v2或v3
close_cb	关闭对话框的回调函数(无参数)
service_type	服务类型，取值如下： 1: 普通蓝钻，开通界面将不显示豪华蓝钻 2: 豪华蓝钻，开通界面将不显示普通蓝钻 3 同时显示不传入此参数: 开通界面将显示普通蓝钻和豪华蓝钻选项
duration	开通时长，取值范围为1 - 24，单位为月。在设置了此参数后，开通界面将不能再手动更改开通时长，付费模式为“按月付费”，且不能手动更改。不传入此参数，付费模式和开通时长均可手动修改。
open_gamevip_mode	蓝钻开通类型，取值如下： 1 给自己开通 2 给好友开通不传入此参数，则默认为给自己开通

4.1.4 范例

GameAPI.NewGameVIPActionEx.show(
10001, // appid
10000000, // mp_id
'39DBE00A043F8DB011391759A3A8A25', // token
1, // zoneid
'000000000000000000000000032373DF', // openid
'v2', // version
function() {alert('close!'), // 回调函数
1, // 蓝钻类型为豪华蓝钻
15 // 开通时长为15个月
);