下载文档

最后更新时间: 2021-02-04 03:12:47 PM

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 用于校验是否成功绑定