客户端协议
查阅当前 Gateway 连接生命周期与 WKProto 数据包边界。
客户端通过 Gateway 的 TCP 或 WebSocket Listener 建立长连接。当前公共基线是同一组 WKProto 语义:连接协商、发送、接收确认和心跳。
协议不是 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 兼容矩阵与实验边界。
当前边界
- 公共核心只包含 CONNECT/CONNACK、SEND/SENDACK、RECV/RECVACK 和 PING/PONG。
DISCONNECT、SUB、SUBACK目前只是 codec 合同,不代表产品 Gateway 已发布对应入口。- 当前产品 Gateway 仅为 benchmark terminal-fence 请求与确认保留
EVENT;它不是应用事件 API。 - WebSocket 可承载 WKProto bytes;JSON-RPC bridge 支持固定 EasySDK 的核心在线路径,其余方法仍按矩阵标为实验性或缺失。