# 游戏接入视频号直播任务指引

curl "https://game.weixin.qq.com/cgi-bin/gameliveapi/gettaskdetailforgame?access_token=51_MLJ3r4CmcrHc5ill2OS46Ns-ZzDfzbK1PPCjU3r1eg2--qSDcmrzVWbJDOqkHJej_jgn6cvtMWSqxpI5VcblfVAFVILZPWNSC6_dTBtMRHk" -H 'Content-Type:application/json' -d '{"appid":"wx76fc280041c16519", "task_auth_list":[{"task_id":"test","task_key":"test"}]}'

enum TaskCondtionType {
  // 观众指标：2、6、7；主播指标：1、2、3、4、5
  // 对于主播来说，观时就是指“该直播被所有观众观看的总时长”；直播时长是“该场直播的总持续时间”。 
  TaskConditionTypeUV = 1;               // uv
  TaskConditionTypeWatchTime = 2;        // 观时，主播和观众共用
  TaskConditionTypeRewardValue = 3;      // 打赏
  TaskConditionTypeIncreaseFansNum = 4;  // 粉丝增加数量
  TaskConditionTypeLiveDuration = 5;     // 直播时长

  TaskConditionTypeLikeCount = 6;        // 点赞次数, for观众
  TaskConditionTypeShareCount = 7;       // 分享次数, for观众  
}
message TaskAuth {
  optional string task_id = 1;  // 确认任务内容后联系@v_ynyaoliao配置并告知task_id&task_key
  optional string task_key = 2;
}

enum GeneralTaskType {
  GeneralTaskTypeAnchor = 0;    // 主播任务
  GeneralTaskTypeAudience = 1;  // 观众任务
}

message GetTaskDetailForGameRequest {
  optional string  appid    = 1;             // 游戏appid
  repeated TaskAuth task_auth_list = 2;  // 获取的任务列表
  optional string user_id = 3;           // 用户身份信息，ex. openid、游戏侧id等，建议传，便于排查问题
  optional uint32 general_task_type = 4; // 观众任务or主播任务  enum GeneralTaskType
}

message TaskConditionList {
  repeated TaskCondition condition_list = 1;  // 条件列表
  optional uint32 task_relation = 2;          // 1与/2或
}

message TaskCondition {
  optional string condition_desc = 1;  // 任务描述
  optional uint64 value = 2;           // 任务进度（管理端配置允许返回才返回）
  optional uint64 target_value = 3;    // 条件目标值
  optional bool is_satisfied = 4;      // 是否满足条件
  optional uint32 condition_type = 5;  // TaskCondtionType     
  optional uint32 period_time = 6;     // 周期时间（秒），0代表统计当前任务起止时间内的历史所有数据
  optional string condition_id = 7;    // 条件id
}

message TaskDetail {
  optional string task_id = 1;
  optional string task_desc = 2;
  optional TaskConditionList task_condition_list = 3;
  optional bool is_satisfied = 4;  // 是否满足条件
}

message GetTaskDetailForGameResponse {
  required int32 errcode = 1;
  optional string errmsg = 2;
  optional OkResult data = 3;

  message OkResult {
    repeated TaskDetail task_detail_list = 1;
  }
}

{
  "task_detail_list": [
    {
      "task_id": "65",
      "task_desc": "斗地主十月主播招募活动任务1、2 测试",
      "task_condition_list": {
        "condition_list": [
          {
            "target_value": 1,      // 目标值
            "is_satisfied": true,   // 是否满足条件
            "condition_type": 1,    // uv 条件类型 见 TaskCondtionType
            "period_time": 86400,   // 任务周期
            "condition_id": "330",  // 条件id
            "value":1                 // 当前进度
          },
          {
            "target_value": "1",
            "is_satisfied": true,
            "condition_type": 5,
            "period_time": 86400,
            "condition_id": "331"
          }
        ],
        "task_relation": 1 // 1与/2或
      },
      "is_satisfied": true
    }
  ]
}