Skip to content
On this page

元事件

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

生命周期

字段名数据类型可能的值说明
timenumber (int64)-事件发生的时间戳
self_idnumber (int64)-收到事件的机器人 QQ 号
post_typestringmeta_event上报类型
meta_event_typestringlifecycle元事件类型
sub_typestringenabledisableconnect事件子类型,分别表示 OneBot 启用、停用、WebSocket 连接成功

WARNING

目前生命周期元事件中,只有 HTTP POST 的情况下可以收到 enabledisable,只有正向 WebSocket 和反向 WebSocket 可以收到 connect

心跳

字段名数据类型可能的值说明
timenumber (int64)-事件发生的时间戳
self_idnumber (int64)-收到事件的机器人 QQ 号
post_typestringmeta_event上报类型
meta_event_typestringheartbeat元事件类型
statusobject-状态信息
intervalnumber (int64)-到下次心跳的间隔,单位毫秒

其中 status 字段的内容和 get_status 接口的快速操作相同。

相关配置

配置项默认值说明
heartbeat.enablefalse是否启用心跳机制
heartbeat.interval15000产生心跳元事件的时间间隔,单位毫秒