QQ游戏开放平台

接入wiki索引

GameAPI.AntiAddiction

4.1.1功能说明

注册防沉迷系统的回调函数

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.AntiAddiction.Register(callback);

参数名称	含义
callback	游戏侧定义的回调函数，有一个输入参数：rate，用于QQGame防沉迷平台返回游戏经验倍率。Rate取值有三种：1、0.5和0，分别表示100%经验、50%经验和0经验该回调函数只在用户经验倍率发生变化时回调

4.1.4 沙箱环境说明

配置以下hosts
119.147.126.228 fcm.ieodopen.qq.com

调用以下接口可设置沙箱环境在线时长
//fcm.ieodopen.qq.com/csec/fcm_cscmodify_req?callback=?&platform=6&appid=$appid&uin=$uin&g_tk=&gametime=$your_time

测试过程可参照下述：
qq=1234567的用户a在appid=10000000游戏中调用js
api，注册回调函数，随后通过设置接口修改号码a的在线时长为180秒，等待五分钟，查看回调函数中的输入参数rate是否有变化
设置接口可参照如下链接：
//fcm.ieodopen.qq.com/csec/fcm_cscmodify_req?callback=?&platform=6&appid=10000000&uin=1234567&g_tk=&gametime=180
Notice: 测试防沉迷接口前，需要确保当前测试用户未进行过实名注册，或实名注册年龄为未成年，否则以上接口恒定返回rate=1

4.1.5 范例

GameAPI. AntiAddiction.Register(
function(rate)
{
alert('current rate is ' + rate); // 回调函数
}
);

QQ游戏 开放平台