消息、通知、请求三大类事件是与聊天软件直接相关的、机器人真实接收到的事件,除了这些,OneBot 自己还会产生一类事件,这里称之为「元事件」,例如生命周期事件、心跳事件等,这类事件与 OneBot 本身的运行状态有关,而与聊天软件无关。元事件的上报方式和普通事件完全一样。
字段名 |
数据类型 |
可能的值 |
说明 |
time |
number (int64) |
- |
事件发生的时间戳 |
self_id |
number (int64) |
- |
收到事件的机器人 QQ 号 |
post_type |
string |
meta_event |
上报类型 |
meta_event_type |
string |
lifecycle |
元事件类型 |
sub_type |
string |
enable 、disable 、connect |
事件子类型,分别表示 OneBot 启用、停用、WebSocket 连接成功 |
注意,目前生命周期元事件中,只有 HTTP POST 的情况下可以收到 enable
和 disable
,只有正向 WebSocket 和反向 WebSocket 可以收到 connect
。
字段名 |
数据类型 |
可能的值 |
说明 |
time |
number (int64) |
- |
事件发生的时间戳 |
self_id |
number (int64) |
- |
收到事件的机器人 QQ 号 |
post_type |
string |
meta_event |
上报类型 |
meta_event_type |
string |
heartbeat |
元事件类型 |
status |
object |
- |
状态信息 |
interval |
number (int64) |
- |
到下次心跳的间隔,单位毫秒 |
其中 status
字段的内容和 get_status
接口的快速操作相同。
配置项 |
默认值 |
说明 |
heartbeat.enable |
false |
是否启用心跳机制 |
heartbeat.interval |
15000 |
产生心跳元事件的时间间隔,单位毫秒 |