元事件
消息、通知、请求三大类事件是与聊天软件直接相关的、机器人真实接收到的事件,除了这些,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 | 产生心跳元事件的时间间隔,单位毫秒 |
| 上一节 | 下一节 |
|---|---|
| 请求事件 | 无 |
