Skip to content

元事件 ​

元事件是线上层(OneBot)特有的,语义层没有对应物。它们由适配器自己产生, 不来自 QQ 推送。

生命周期 ​

json
{
  "time": 1763200000,
  "self_id": 123456789,
  "post_type": "meta_event",
  "meta_event_type": "lifecycle",
  "sub_type": "connect"
}
sub_type时机
connect适配器启动完成、action 已注册、网络已监听
enable预留(当前不发)
disable预留(当前不发)

每个连接独立下发

connect 是在连接建立时发给该连接的,不是全局广播一次。所以后连上的客户端也能收到。

心跳 ​

json
{
  "time": 1763200000,
  "self_id": 123456789,
  "post_type": "meta_event",
  "meta_event_type": "heartbeat",
  "status": { "online": true, "good": true },
  "interval": 5000
}
字段说明
interval心跳间隔(ms)
status.online当前是否在线
status.good是否正常(预留,当前恒 true)

这是 OneBot 心跳,不是 SSO 心跳

两者完全不同,不要混:

心跳谁维持间隔作用
OneBot 心跳适配器(TS 侧定时器)默认 30s,可配告诉客户端「我还活着」
SSO 心跳native(C++ 侧)内部固定向 QQ 服务端保活

OneBot 心跳停了不影响在线状态;SSO 心跳失败才会掉线。

关闭心跳 ​

heartbeatMs 默认 30000。设成 0 就不发:

ts
createOneBotAdapter({ ..., heartbeatMs: 0 })

固定 30 秒

createBot() 目前不暴露这个参数,走默认值。要改只能直接调 createOneBotAdapter。

与语义层的对应 ​

线上层语义层
meta_event / lifecycle / connect无(适配器状态)
meta_event / heartbeat无(适配器状态)
—BotEvent 的 online / offline / state / heartbeat(SSO 层)

语义层的 heartbeat 是一次 SSO 心跳往返(带 rttMs),与 OneBot 的 meta_event.heartbeat 是两回事。见会话事件。

版本未定(0.0.0 是占位);文档与代码同步演进,以主仓为准