[关闭]
@iamzealotwang 2015-08-19T08:06:42.000000Z 字数 9420 阅读 876

任务系统

任务

任务类型概述

扩展需求

互动型任务找人说明

新任务抓取逻辑

普通/VIP 流程图

Created with Raphaël 2.1.2客户端请求服务端推送M个任务推送已有主动任务(MetaID 3000+)是否还有剩余?推送已有被动任务(MetaID 4000+)是否还有剩余?3000+任务<1 并且 2000+任务<1？推送1个新的互动发起任务(MetaID 2000+)是否还有剩余?推送单人任务(1000+)返回最终选择结果返回最终选择结果返回最终选择结果返回最终选择结果yesnoyesnoyesnoyesno

双语明星 流程图

Created with Raphaël 2.1.2客户端请求服务端推送M个任务推送已有主动任务(MetaID 3000+)是否还有剩余?新的互动发起任务(MetaID 2000+)<1？推送1个新的互动发起任务(MetaID 2000+)是否还有剩余?推送已有被动任务(MetaID 4000+)是否还有剩余?推送单人任务(1000+)返回最终选择结果返回最终选择结果返回最终选择结果返回最终选择结果yesnoyesnoyesnoyesno

新任务(2000+)推送的用户选择逻辑

说明及定义

中国

Created with Raphaël 2.1.2选择20人找出所有可推送新用户兴趣匹配找用户是否还有剩余?找出其他VIP用户兴趣匹配找用户是否还有剩余?返回最终选择结果返回最终选择结果返回最终选择结果yesnoyesno
Created with Raphaël 2.1.2选择20人找出所有VIP用户兴趣匹配15个用户找出非VIP用户兴趣匹配5个用户返回最终选择结果

美国

补充需求

任务检测类型

Club相关

> - 进入某个Club(ex:进入动物Club)       -----> **MissionTypeClubEnter**
> - Club中上传照片                      -----> **MissionTypeClubUploadPhoto**
> - Club中Like照片                      -----> **MissionTypeClubLikePhoto**
> - Club中给照片Feedback                -----> **MissionTypeClubFeedbackOnPhoto**
> - Club中给照片Comment                 -----> **MissionTypeClubCommentOnPhoto**
> - Club中给别人ThankYou                -----> **MissionTypeClubGiveThankYou**

CardCenter相关

> - CardCenter 发送卡片         -----> **MissionTypeCardSendCard**
> - CardCenter Like一张卡片     -----> **MissionTypeCardLikeCard**
> - CardCenter 翻看一张卡片     -----> **MissionTypeCardFlipCard**

1V1相关

> - 1v1 Chat中发送文字          -----> **MissionTypeChatWriteTextMessage**
> - 1v1 Chat中发送图片          -----> **MissionTypeChatSendImageMessage**
> - 1v1 Chat中发送语音          -----> **MissionTypeChatSendVoiceMessage**

游戏相关

> - 更改Profile                 -----> **MissionTypeProfileEdit**
> - 商店中购买物品              -----> **MissionTypeShopBuyCoinsItme**
> - 更换家中壁纸                -----> **MissionTypeHomeChangeBackground**
> - 更换家中墙上照片            -----> **MissionTypeHomeChangeWallImage**
> - 访问好友家                  -----> **MissionTypeFriendVistiFriend**
> - 发送好友请求                -----> **MissionTypeFriendSendAddFriendRequest**
> - 接受好友请求                -----> **MissionTypeFriendAcceptFriendRequest**
> - 使用虫洞                    -----> **MissionTypeSceneUseWormhole**

照片审核

> - 照片审核                    -----> **MissionTypeExaminePhoto**

MessionConfig 解析需求

MissionMeta格式

  2. //tutorialMissionArray 新手教学Mission
  3. //selfMissionArray 可以自己完成的Mission
  4. //initiativeMissionArray 主动发触发多人任务的Mission(一旦发完卡片后该任务结束)
  5. //engageMissionArray 互动型任务中-主动方的Mission
  6. //passivityMissionArray 互动型任务中-被动方的Mission
  7. //在initiativeMissionArray中有MissionTags,后端用于兴趣相投模块查找卡片
  8. //isUseStepReward 表示是否使用分步的奖励配置,如果为True则奖励读取missionStepArray中的值
  9. //isOnceDaily 是否为每日仅推送一次的任务
  12. {
  13.   "tutorialMissionArray": [
  14.     {
  15.       "missionID": 1,
  16.       "missionImgURL": "http://114.215.136.114:8085/metafile/missionImg/20.png",
  17.       "missionType": "selfMission", 
  18.       "title_CN": "完善个人资料",
  19.       "title_EN": "改自己的Profile",
  20.       "desc_CN": "在家中好让更多的人了解你，想与你做朋友。",
  21.       "desc_EN": "改自己的Profile",
  22.       "rewardCoins": 100,
  23.       "rewardExp": 100,
  24.       "isUseStepReward": false,
  25.       "isOnceDaily":false //是否为每日仅推送一次的任务
  26.       "missionStepArray": [
  27.         {
  28.           "rewardCoins": "70",
  29.           "rewardExp": "20",
  30.           "rewardDiamond": "0",
  31.           "index": 0,
  32.           "desc_CN": "完善个人资料",
  33.           "desc_EN": "改自己的Profile",
  34.           "triggerType": "MissionTypeProfileEdit",
  35.           "triggerNum": 1
  36.         }
  37.       ]
  38.     }
  39.   ],
  40.   "selfMissionArray": [
  41.     {
  42.       "missionID": 1001,
  43.       "missionType": "selfMission",
  44.       "title_CN": "动物保护神",
  45.       "title_EN": "Animal Guardian",
  46.       "desc_CN": "动物俱乐部上传照片",
  47.       "desc_EN": "Hey! Warrior of Animuick share it with other warrior in Animal Club!",
  48.       "rewardCoins": 100,
  49.       "rewardExp": 100,
  50.       "missionStepArray": [
  51.         {
  52.           "index": 0,
  53.           "desc_CN": "在动物俱乐部中上传1张动物照片",
  54.           "desc_EN": "Upload 1 Photos in Animal Club",
  55.           "triggerType": "MissionTypeClubUploadPhoto",
  56.           "ext": {
  57.             "clubID": 3
  58.           },
  59.           "triggerNum": 1
  60.         },
  61.         {
  62.           "index": 1,
  63.           "desc_CN": "在动物俱乐部上传照片的任务",
  64.           "desc_EN": "Upload 1 Photos in Animal Club",
  65.           "triggerType": "MissionTypeClubUploadPhoto",
  66.           "ext": {
  67.             "clubID": 3
  68.           },
  69.           "triggerNum": 1
  70.         }
  71.       ]
  72.     }
  73.   ],
  74.   "initiativeMissionArray": [
  75.     {
  76.       "missionContry": "CN", //哪个国家的用户可以接收到当前Mission (CN,EN,ALL)
  77.       "missionID": 2000,
  78.       "engageMissionID": 3000,
  79.       "rewardCoins": 100,
  80.       "rewardExp": 100,
  81.       "title": "你最喜欢的男歌星",
  82.       "desc": "你最喜欢的男歌星是谁呢？在卡片中心找一个你最喜欢的男歌星并且告诉大家为什么",
  83.       "missionTags": "女歌星#女演员"
  84.       "missionStepArray": [
  85.         {
  86.           "index": 0,
  87.           "desc": "发送一张男歌星的卡片",
  88.           "triggerType": "missionSendCard",
  89.           "triggerNum": 1
  90.         }
  91.       ]
  92.     }
  93.   ],
  94.   "engageMissionArray": [
  95.     {
  96.       "missionID": 3000,
  97.       "relateMissionID": 4000,
  98.       "missionType": "engageMission",
  99.       "title": "和#UserName#一起聊聊你最喜欢的男歌星",
  100.       "desc": "#UserName#想觉得你发的卡片很有兴趣呢,快快和他一起聊聊你喜欢的这位男歌星吧!",
  101.       "rewardCoins": 100,
  102.       "rewardExp": 100,
  103.       "minimumFinishGroupNum": 3,
  104.       "broadcastGroupNum": 10,
  105.       "isShowMissionFinishQualityMark": true, //是否显示任务完成质量评分
  106.       "isShowVoicePracticeMark": true, //是否显示语音质量评分
  107.       "isShowTextPracticeMark": true, //是否显示练习质量评分
  108.       "missionStepArray": [
  109.         {
  110.           "index": 0,
  111.           "desc": "和#UserName#聊聊和这个男歌星相关的信息",
  112.           "triggerType": "typeChatWriteTextMessage",
  113.           "triggerNum": 3,
  114.           "finishAction": "relateMissionNextStep" //当前任务关联任务进入下一步
  115.         },
  116.         {
  117.           "index": 1,
  118.           "desc": "等待#UserName#给你的回复,记得要常回来看看呦!",
  119.           "triggerType": "waitServer" //等待服务器设置该步完成
  120.         },
  121.         {
  122.           "index": 2,
  123.           "desc": "Hey!太厉害了,再和#UserName#聊聊这个歌星吧",
  124.           "triggerType": "typeChatWriteTextMessage",
  125.           "triggerNum": 2
  126.         }
  127.       ]
  128.     }
  129.   ],
  130.   "passivityMissionArray": [
  131.     {
  132.       "missionID": 4000,
  133.       "missionType": "passivityMission",
  134.       "missionImgURL": "http://114.215.136.114:8085/metafile/missionImg/MissionTest.png",
  135.       "relateMissionID": 3000, //和当前任务关联的任务MetaID
  136.       "title": "Chat with #ownerUserName# about the male singer!",
  137.       "desc": "Hey! #UserName# is big fan of this singer, why don't you guys chat about this?",
  138.       "rewardCoins": 100,
  139.       "rewardExp": 100,
  140.       "isShowMissionMark": true, //是否显示任务完成质量评分
  141.       "isShowVoicePracticeMark": true, //是否显示语音质量评分
  142.       "isShowTextPracticeMark": true, //是否显示练习质量评分
  143.       "missionStepArray": [
  144.         {
  145.           "index": 0,
  146.           "desc": "Give #UserName# some feedback base on what he wrote",
  147.           "triggerType": "typeChatWriteTextMessage",
  148.           "triggerNum": 1,
  149.           "finishAction": "relateMissionStart" //当前任务关联任务开始
  150.         },
  151.         {
  152.           "index": 1,
  153.           "desc": "Wating #UserName# write more message.",
  154.           "triggerType": "waitServer" //等待服务器设置该步完成
  155.         },
  156.         {
  157.           "index": 2,
  158.           "desc": "Give #ownerUserName# some feedback base on what he wrote",
  159.           "triggerType": "typeChatWriteTextMessage",
  160.           "triggerNum": 1,
  161.           "finishAction": "relateMissionNextStep" //当前任务关联任务进入下一步
  162.         }
  163.       ]
  164.     }
  165.   ]
  166. }

MissionVo格式

SelfMissionVo

  2. {
  3.   "uuid":"xxxxx",
  4.   "missionMetaID": 2000,
  5.   "isFinish": false, //当前任务完成
  6.   "isGainReward": false, //当前任务已领奖
  7.   "isTodayInProgress":true //是否今日有进展(前端用于任务排除)
  8.   "userName":"xxx",
  9.   "userAvtartImgURL":"xxxx",
  10.   "userID":"xxxx",
  11.   "missionStepArray": [
  12.     {
  13.       "index": 0,
  14.       "stepNum": 3,
  15.       "isFinish": true
  16.     },
  17.     {
  18.       "index": 1,
  19.       "stepNum": 3,
  20.       "isFinish": true
  21.     }，
  22.     {
  23.       "index": 2,
  24.       "stepNum": 3,
  25.       "isFinish": false
  26.     }
  27.   ]
  28. }

Rpc请求接口

  1. function requestMissionMetaConfigURL
  3. return 
  4. {
  5.     "uri":"xxxxxxx" //返回的地址无Http前缀
  6. }
  1. function requestDailyMissionListAndRefreshTime
  3. parameter 
  4. {
  5.    "clientDate":"0000000000000" //玩家当前的时间秒数(后端用于判断是否执行清空逻辑)
  6. }
  8. return 
  9. {
  10.     "historyStarNum":5  //成就页面中需要展示的星星数量
  11.     "activeMissionVoList":[] //当前活跃的任务列表(里面的格式为MissionVo)
  12.     "newMissionRefreshCountDownTime":3000 //刷新按钮剩余倒计时时间
  13. }
  1. function requsetNewMission
  3. parameter
  4. {
  5.     "totoalInteractiveMissionNum":1 //当前角色已有的互动任务数量
  6.     "num":7 //请求的任务数量
  7.     "is_new_user": //当前是否请求新手任务
  8. }
  10. return
  11. {
  12.     "newMissionVoList":[] //新的任务列表(里面的格式为MissionVo)
  13. }
  1. function commandMissionVoChange
  3. parameter
  4. {
  5.     "uuid":"xxxxx" //Mission的唯一ID
  6.     "missionMetaID":3000 //
  7.     "stepIndex":1 //第几步有进展
  8.     "stepAddNum":1 //当前步骤加ji
  9.     "isStepFinish":true //当前步骤是否完成
  10.     "isMissionFinish":true //当前任务是否完成
  11.     "isEngageMission":true //当前任务是否为互动型任务
  12. }
  1. function commandGainMissionReward
  3. parameter
  4. {
  5.     "uuid":"xxxxx"
  6.     "missionMetaID":3000
  7. }
  1. function commandRatingOnInteractiveMission
  3. parameter
  4. {
  5.     "missionUUID":xxx,
  6.     "interactUserID":"xxx", //和当前用户互动的那个人的ID
  7.     "finshQualityRating":1~5,
  8.     "voiceRating":1~5,
  9.     "languageRating":1~5
  10. }
  1. function commandMissionCardChat
  3. parameter
  4. {
  5.     "cardID":"xxxxxx"
  6.     "userIDArray":[]
  7.     "message":"xxx"
  8.     "mission_id":"xxx"
  9.     "country":0
  10. }
  1. function commandAddTodayStarNum
  3. parameter null
  1. function requestMissionMetaConfigURL
  3. parameter null
  5. return
添加新批注
在作者公开此批注前，只有你和作者可见。
回复批注