OneBot 启动后,作为客户端向用户配置的反向 WebSocket URL 建立连接。连接建立后,将一直保持连接,并根据连接的 URL 不同,提供 API 调用或事件推送服务。通过 WebSocket 消息发送的数据全部使用 JSON 格式。
根据配置的不同,连接用户提供的 URL 的客户端有三种:API 客户端、Event 客户端和 Universal 客户端。API 客户端提供 API 调用服务;Event 客户端提供事件推送服务;Universal 客户端在一条连接上同时提供两种服务。
注意
只要服务器能够正确区分,API 客户端和 Event 客户端可以向同一个 URL 建立连接,但这是两条连接,和 Universal 客户端不同。
各客户端建立连接的方式相同,以 API 客户端为例,假设设置了 API URL 为 ws://127.0.0.1:8080/ws/api
,则连接请求如下:
GET /ws/api HTTP/1.1
Host: 127.0.0.1:8080
Connection: Upgrade
Upgrade: websocket
X-Self-ID: 10001000
X-Client-Role: API
...
请求头中的 X-Self-ID
表示当前正在建立连接的机器人 QQ 号;X-Client-Role
表示当前正在建立连接的客户端类型,对于 Event 客户端和 Universal 客户端,这里分别是 Event
和 Universal
。
连接建立后,使用方式同 正向 WebSocket。
当由于各种意外情况,连接断开时,OneBot 将以配置中指定的时间间隔不断尝试重连,直到再次连接成功。
配置项 | 默认值 | 说明 |
---|---|---|
ws_reverse.enable |
true |
是否启用反向 WebSocket |
ws_reverse.url |
空 | 反向 WebSocket API、Event、Universal 共用 URL |
ws_reverse.api_url |
空 | 反向 WebSocket API URL,如果为空,则使用 ws_reverse.url 指定的值 |
ws_reverse.event_url |
空 | 反向 WebSocket Event URL,如果为空,则使用 ws_reverse.url 指定的值 |
ws_reverse.use_universal_client |
false |
是否使用 Universal 客户端 |
ws_reverse.reconnect_interval |
3000 |
反向 WebSocket 客户端断线重连间隔,单位毫秒 |
上一节 | 下一节 |
---|---|
正向 WebSocket | 鉴权 |