# Socket连接

## 文档说明

建立socket连接，是游戏和平台客户端之间唯一的通信方式。所有接入GTarcade平台的游戏，均需要在接入前建立socket连接，本文档为此接入流程提供指引。

Gtarcade会在启动游戏进程时，通过传参的形式来告知游戏发行方socket端口号等信息（具体：账号信息，游戏id，区服id， 渠道id， 语言类型，socket端口port），游戏方可以通过port来进行socket建链操作。



## 加密方式

游戏方与微端通过socket通信，一般情况下都需要加密（心跳不需要）。如需加密秘钥，请联系官方平台人员。

## 心跳

> 为了监测游戏的在线情况，如有问题微端可以适时的作出相应的调整

+ 心跳时间间隔为 5s，如果连续三次超过 5s 没有收到心跳，视为游戏出现不
  可逆错误，通知用户。

**通信方式：** （TCP）
**加密方式：** 不加密
**平台发送数据：** 0
**游戏返回平台数据：** 0



## 获取机器相关设备信息

> 游客模式用户绑定是否成功

**通信方式：** 游戏向微端发起请求（TCP）
**加密方式：** AES
**数据格式：** JSON
**参数内容：**

| 参数名      | 必选 | 类型 | 说明                                           |
| :---------- | :--- | :--- | ---------------------------------------------- |
| gta_id      | 是   | Str  | 每次启动 gta 的唯一 ID                         |
| client_id   | 是   | Str  | 每一个游戏分配的通信 ID                        |
| msg_id      | 是   | Str  | 本地通信的消息 ID，用于分辨每次通信接口,写死19 |
| device_type | 是   | Str  | 请求设备信息类型                               |
| user_id     | 是   | Str  | 绑定用户新的user_id 用于校验是否成功绑定       |

device_type格式：
	可扩展字符串“0000”类型
	0001:获取微端唯一id
	0010：获取CPU序列号
	0100：获取当前网卡序列号
	1000：获取当前操作系统版本
	可同时使用，例如同时获取微端唯一id和CPU序列号可以使用：“0011”字符串

**返回字段**

| 参数名     | 必选 | 类型 | 说明                                           |
| :--------- | :--- | :--- | ---------------------------------------------- |
| gta_id     | 是   | Str  | 每次启动 gta 的唯一 ID                         |
| client_id  | 是   | Str  | 每一个游戏分配的通信 ID                        |
| msg_id     | 是   | Str  | 本地通信的消息 ID，用于分辨每次通信接口,写死19 |
| gta_client | 是   | Str  | gta的clientid,唯一设备号                       |
| gta_cpu    | 是   | Str  | cpu序列号                                      |
| gta_mac    | 是   | Str  | 网卡id                                         |
| gta_os     | 是   | Str  | 操作系统                                       |
| user_id    | 是   | Str  | 绑定用户新的user_id 用于校验是否成功绑定       |