新游预约

1. 背景

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

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

2. 示例

3. 小程序接入

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

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

重点注意的QueryString参数：

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

4.平台查询接口

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

   请求参数：
   公共参数

   签名计算：
   sig 计算

   请求路由：

   POST https://s1.livelink.qq.com/livelink/?apiName=GetAppt&sig=bb437c4a19190014bbd875e7c2098e2c&gameId=cf&code=1IlzKlwbruO9ebjOCTMocUi46W%2FNrD0v%2FVOTaXK2a82k1kTD%2Fe3KTnjs1UnmlkYsvpEW90VGxTPsfPIH8LuHFdx%2B0dGGj4bnlu44UJ84DlfYSDkqJENyHuHEylqDEl36&t=1747813994&livePlatId=xxx&v=2.0&actId=0&nonce=g8prbo9o
   
   

   请求参数：

   ```json
   {
    // 这里传空即可
   }

返回参数：

{
  "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
}