WebSocket API
获取配置并从响应主体的 .ws.server
属性得到需连接的 WebSocket URI。连接中以 JSON 文本形式传输以下消息,其中 初始数据、接收数据 和 发送数据 的类型在具体频道的文档说明。
请求加入频道
方向 |
客户端 → 服务端 |
内容 |
ServerboundJoinChannelMessage |
离开频道
方向 |
客户端 → 服务端 |
内容 |
ServerboundDisconnectChannelMessage |
发送数据
方向 |
客户端 → 服务端 |
内容 |
ServerboundDataMessage<发送数据> |
成功加入频道
客户端请求加入频道且校验通过后服务器发送。
方向 |
服务端 → 客户端 |
内容 |
ClientboundJoinResultMessage<初始数据> |
心跳
对于客户端已加入的每个频道,服务器每 90 秒左右发送。
方向 |
服务端 → 客户端 |
内容 |
ClientboundHeartbeatMessage |
被踢出频道
另一客户端持相同非空 exclusive_key
加入同一频道后服务器发送。
方向 |
服务端 → 客户端 |
内容 |
ClientboundExclusiveKickoffMessage |
接收数据
方向 |
服务端 → 客户端 |
内容 |
ClientboundServerBroadcastMessage & 接收数据 |