输出条件信息

接口说明

此接口旨在提供流程中条件接口字段的输出功能。用户可以配置接口，以选择输出原始值（例如，对局次数为10次）或布尔类型值（即在腾讯游戏来联后台进行数值对比后的结果）。通过这种方式，用户可以灵活地获取和展示条件信息，以满足不同的需求和应用场景。

场景：

• 展示用户的当前击败数与期望击败数，以便用户直观对比进度，明确自己与目标之间的距离。
• 展示用户当前的角色等级和所期望达到的用户等级，助力用户迅速了解自身等级状况，判断是否符合活动或任务要求。
• 在任务列表中明确标注用户各项任务的完成状态，使用户能够一目了然地掌握任务进度，提升用户体验。

请求示例

curl "https://s1.livelink.qq.com/livelink/?
apiName=ApiRequest&livePlatId=xx&actId=1201&gameId=cf&v=2.0&t=&nonce=&code=diVa28UpyL5G%2BVmKNVIcg%3D%3D&sig=e3909d0a2cb7f7d8f2ec03fb4ea96007"
 -d '{"flowId":"69f33ur0"}'

先决条件

• 在流程（如:示例中流程 69f33ur0 ）的结果配置必须使用"输出条件数据(2.0版本)"

注意事项

• 流程只能于输出只读接口数据。
• 该流程不应该配置为带有写操作的接口功能（如扣除积分，道具发放等）。

腾讯游戏来联运营配置界面

输出举例

{
  "iRet": 0,
  "v": 2,
  "apiName": "FlowConditionQuery",
  "jData": [
    {
      "secure": 0,
      "name": "cf每日击杀",
      "api": "cf_daily_kill",
      "quota": "kill_num",
      "quotaName": "用户当天击杀数",
      "compVal": false,
      "expectVal": 10,
      "curVal": 2
    },
    {
      "secure": 1,
      "name": "cf用户属性",
      "api": "user_attr",
      "quota": "user_level",
      "quotaName": "用户等级",
      "compVal": false,
      "expectVal": 50,
      "curVal": 6
    }
  ]
}

返回说明

参数	类型	说明
secure	int	安全设置： 返回0：curVal字段将包含用户游戏的具体数值 返回1：返回布尔类型，结果存储在compVal中，此时curVal中的数值无效
name	string	数据接口的中文名称
api	string	数据接口的ID标识
quota	string	接口返回中的字段ID。例如：cf接口返回用户注册时间与当日登录，则该接口可以包含两个字段，分别为注册时间和当日登录
quotaName	string	字段的中文名称
expectVal	int	由腾讯游戏来联人员配置的预期值。若接口返回布尔类型，则表示当前实际游戏数值与该值的对比结果
curVal	int	用户当前的具体数值。例如：当日游戏击败5人。出于安全考虑，并非所有游戏都同意返回此类信息
compVal	bool	布尔类型，表示用户在此字段中的判定结果