QQ游戏 开放平台

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

4.4 GameAPI.NewGameVIPAction

功能说明

新版的通过活动开通蓝钻后,使用此接口来领取相应的活动礼包(推荐使用)。

调用说明

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平台,并在平台发布白名单后在大厅测试专区中,使用测试号码进行调试。

调用方式

GameAPI. NewGameVIPAction.show(appid, mp_id, token, zoneid, openid, version, close_cb, service_type, duration, open_gamevip_mode,duration_type);

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

范例1

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

范例2

GameAPI.NewGameVIPAction.show(.
10001, // appid
10000000, // mp_id
'39DBE00A043F8DB011391759A3A8A25', // token
1, // zoneid
'000000000000000000000000032373DF', // openid
'v3', // version
function() {alert('close!'), // 回调函数
1, // 蓝钻类型为豪华蓝钻
15, // 开通时长为15个月
‘!month’ //只按月显示付费模式
);
图片