元事件

消息、通知、请求三大类事件是与聊天软件直接相关的、机器人真实接收到的事件,除了这些,OneBot 自己还会产生一类事件,这里称之为「元事件」,例如生命周期事件、心跳事件等,这类事件与 OneBot 本身的运行状态有关,而与聊天软件无关。元事件的上报方式和普通事件完全一样。

生命周期

字段名 数据类型 可能的值 说明
time number (int64) - 事件发生的时间戳
self_id number (int64) - 收到事件的机器人 QQ 号
post_type string meta_event 上报类型
meta_event_type string lifecycle 元事件类型
sub_type string enabledisableconnect 事件子类型,分别表示 OneBot 启用、停用、WebSocket 连接成功

注意,目前生命周期元事件中,只有 HTTP POST 的情况下可以收到 enabledisable,只有正向 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 产生心跳元事件的时间间隔,单位毫秒

上一节 下一节
请求事件