创建长连接通道

最近更新时间:2024-08-29 15:12:21

我的收藏

接口说明

建立 websocket 长连接通道,上行发送驱动指令、接收下行消息。

调用协议

WebSocket + JSON
WSS /v2/ws/ivh/interactdriver/interactdriverservice/commandchannel
Header Content-Type: application/json;charset=utf-8

建连方式(重要)

websocket url:参考数智人 aPaas 接口调用方式接口调用方式组织 url,建连后可通过连接对象发送驱动指令来控制数智人。
注意:
建立长链接通道需要使用公共参数requestid来发起连接请求。
需额外注意的是 requestid 参数填写会话 id(SessionId)的值。例如 SessionId=m318552187863054171,那么 url 如下:
wss://domain/v2/ws/ivh/interactdriver/interactdriverservice/commandchannel?appkey=xxx&requestid=m318552187863054171&timestamp=xxx&signature=xxx
websocket 可能会因为网络抖动、云端服务更新等操作产生断连,当检测到断开时只要 session 状态没有关闭则需要重新建连。
请在调用开启会话接口后,再建立 websocket 长链接,不然连接不成功。一个会话只允许创建一个长链接通道。