新游预约

1. 背景

新游预约作为平台绑定游戏账号的补充信息，为玩家提供了更多的选择和便利。它与平台绑定游戏账号的方式并不冲突，反而相辅相成。通过预约，玩家可以确保在游戏上线后第一时间体验到游戏，同时还能享受到一些预约专属的福利和活动。

注意：该方式作为平台绑定游戏账号的补充信息且彼此不冲突。

2. 示例

3. 小程序接入

功能： 跳转小程序进行新游账号绑定

微信小程序：参考跳转微信小程序 QQ小程序：参考跳转QQ小程序

重点注意的QueryString参数：

字段	字段说明	是否需要加入签名（sig）	参数是否必填
type	跳转到新游预约页面的必要参数: newGamePreorder	否	否

4.平台查询接口

1. 查询用户是否预约了某个游戏

   请求参数：
   公共参数

   签名计算：
   sig 计算

   请求路由：

   POST /livelink?c=Index&a=GetAppt

   请求参数：

   {}
   

   返回参数：

   {
     "iRet": 0,
     "sMsg": "ok",
     "jData": {
       "list": [
         {
           "gameAccountId": "xxxxxxxxxx", // 游戏账号id，已预约情况下返回
           "apptTime": 1714299586, // 预约时间，已预约情况下返回
           "accountType": "wx", // qq、wx ；这里会返回游戏支持的登录类型，可以分别预约不同的账号类型
           "status": 0, // 0未预约，1已预约
         }
       ]
     }
   }
   

5. 预约关系变更推送接入（非必需）

5.1 说明

用户在小程序完成预约操作后，腾讯侧可以调用平台的接口，实时通知该用户预约关系发生变化的消息

特别注意：考虑网络延迟先后顺序问题，此处推送给平台只会告知某个平台用户预约关系发生了变化，不会告知具体是已预约或者解除预约，如果平台侧有场景需要记录预约状态，则需要自行调用上面描述的 c=Index&a=GetAppt 接口查询最新状态

5.2 平台接入推送

统一接入说明参考

5.3 推送数据说明

参数	类型	描述
gameCode	string	游戏业务的缩写，腾讯游戏来联已接入业务查询
anchor	string	平台用户id
reqType	string	固定为apptChange
data	string	{"changeTime":1681868951}

推送示例

{
  "reqType": "apptChange",
  "gameCode": "val",
  "anchor": "111",
  "uid": "111",
  "data": "{\"event\": \"bind\",\"changeTime\":1681868951,\"gameAccountId\":\"xxxxxx\","fromId":\"xxxxx\"}" // event可选值为bind（绑定事件）和unbind（解绑事件）,fromId为平台拉起账户绑定传入来源id
}