客户端协议
查阅 WKProto、JSON-RPC 与 MQTT 开发预览接入契约。
客户端通过 Gateway 的 TCP 或 WebSocket Listener 建立长连接。WKProto 公共基线包含连接协商、发送、接收确认和心跳。MQTT 使用独立的 MQTT 5 TCP 入口，共用 IM 用户、频道和消息。
协议不是 HTTP API
TCP 二进制帧和 WebSocket 消息不属于 OpenAPI。这里记录 Wire 与 Gateway 行为，不虚构 HTTP 路径。
连接生命周期
CONNECT 首包、CONNACK、活跃会话、空闲关闭与恢复。
数据包类型
FrameType 0–12、方向和当前发布范围。
TCP 二进制协议
固定头、Remaining Length、字段顺序与版本边界。
加密与安全
X25519、AES-CBC、msg_key 与安全限制。
EasySDK JSON-RPC
核心在线路径、四端 wire 兼容矩阵与实验边界。
MQTT（开发预览）
MQTT 5 TCP、认证、Topic、持久会话、遗嘱与互通。
当前边界
- 公共核心包含 CONNECT/CONNACK、SEND/SENDACK、RECV/RECVACK、PING/PONG 与服务端出站 stream.* EVENT。
- WKProto 的
DISCONNECT、SUB、SUBACK目前只是 codec 合同，不代表产品 Gateway 已发布对应入口。 - 服务端可通过
EVENT投递公开流式消息事件；任意客户端 EVENT 入站仍不支持，入站只接受 benchmark terminal-fence 工具请求。 - WebSocket 可承载 WKProto bytes；JSON-RPC bridge 支持固定 EasySDK 的核心在线路径，其余方法仍按矩阵标为实验性或缺失。