fusion2.iface.updateExpRate

目录


1 功能说明

1. 接口类型:前端JS接口。
2. 接口功能:作为防沉迷接入(详见:防沉迷接入说明)的1个必要步骤,用于获取用户的经验倍率值接口。
3. 功能描述:
(1)腾讯开放平台提供防沉迷自助接入方案,防沉迷系统实现了大部分防沉迷相关的功能,例如用户实名注册检测和注册,对用户进行弹框提醒等。
(2)由于各应用的收益模式相差较大,腾讯防沉迷系统无法控制用户在应用中的收益额度。因此腾讯防沉迷系统提供了本接口,应用可以调用本接口来获取用户的经验值倍率,然后在应用中对用户实施收益减半或清零。
(3)应用无需关注用户在线时长以及是否未成年等信息,这部分逻辑判断由腾讯防沉迷系统去做,然后返回用户的经验倍率值,应用只需要使用该倍率值即可。

4. 接口调用限制:
(1)测试该接口时,需先开启沙箱环境上报数据接口(fusion2.control.enableAntiAddiction())。
(2)应用确认发布防沉迷功能后(详见:防沉迷接入说明#3.3 发布说明),调用该接口才会返回实际的数据。

2 接口调用说明

2.1 调用前的准备

1. 调用本前端接口前,应用中应该部署Fusion2的跨域文件以及引用脚本,请参阅:Fusion2文档

2. 需先开启沙箱环境上报数据接口(该接口只作用于沙箱环境):
fusion2.control.enableAntiAddiction();

2.2 接口调用说明

fusion2.iface.updateExpRate
(

    function (rate) 
    { 
       //在这里写入经验值减半或清零的逻辑。
       //应用无需关注用户在线时长以及是否未成年等信息,这部分逻辑判断由腾讯平台去做,平台返回用户的经验倍率值rate
       //应用只需要使用rate值即可。rate为经验倍率,有1,0.5,0  这3种取值 
       //当rate=1时,因此用户的收益保持不变,FusionAPI不会回调本方法
       //当rate=0.5或0时,表示用户是FusionAPI会回调本方法,对用户实施收益减半或清零
    }

)


示例代码:

function fcm()
{

 //开启沙箱环境上报数据接口
 fusion2.control.enableAntiAddiction();


 //调用防沉迷接口
  fusion2.iface.updateExpRate
  (
      function(rate)
      {
         //在这里写入经验值减半或清零的逻辑。
         //alert(rate);
      }   
  )

}


2.3 调用示例

function fcm()
{

 //开启沙箱环境上报数据接口
 fusion2.control.enableAntiAddiction();


 //调用防沉迷接口
  fusion2.iface.updateExpRate
  (
      function(rate)
      {
         //在这里写入经验值减半或清零的逻辑。
         //alert(rate);
      }   
  )

}


2.4 关于本接口不返回rate的说明

1. fusion2.iface.updateExpRate回调rate方法是在rate值发生变化的时候。因此如果rate移植不发生变化,就不会发生回调,则不返回rate。
例如当用户为实名成年用户时,rate值一直为1,不会发生回调;
当用户为未成年玩家,进行游戏达到3小时后,rate值从1变为0.5,会发生回调。

2. 如果是沙箱环境下调试,需要使用fusion2.control.enableAntiAddiction()开启沙箱环境上报,才能正常调试。

2.5 关于用户在线时长一直为0的说明

1. 当用户为注册了防沉迷系统的成年玩家时,在线时长会一直为0。
2. 只有测试QQ号的在线时长可以在防沉迷的在线时长查询联调工具中查询和调整。

3. 接口测试联调说明

详见:防沉迷接入说明#3.2 测试联调说明

以上信息是否解决您的问题?

Copyright © 1998 - 2019 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部