WebSocket

介绍

开放平台支持开发者通过WebSocket进行事件订阅,当开发者将事件订阅的连接模式更改为WebSocket时,开放平台会将各类事件消息统一推送至WebSocket连接通道

切换模式

进入开发者平台在新窗口打开,点开需要配置的应用,进入机器人管理 > 事件订阅页面,将连接模式切换为WebSocket

开始连接

通过获取WebSocket连接接口获取到WSS连接节点,通过WSS连接节点进行连接

连接保持

WebSocket连接上后,客户端需要30秒发送一次ping心跳包来保持连接状态,否则服务器会主动断开连接。如果你使用的WS组件没有自动心跳,你也可以每间隔30秒发送以下数据包来模拟心跳

{
    "type": 1
}

连接恢复

WebSocket断连后,一般情况下可通过原连接节点重新连接,若是由于重置token导致的断连,则需要通过获取WebSocket连接接口重新获取最新连接节点进行连接

数据补发

WebSocket连上后,会补发最近3分钟内的消息,最多80条

事件接收

WebSocket连上后,开放平台会将事件消息统一推送至WebSocket连接通道,开发者获取到事件消息后,可以针对事件消息进行相应的处理