跳转至

元事件

提示

本页所定义的事件均基于 OneBotRPC - 事件,其中 type 字段值应为 meta

后面的定义中只给出 detail_typesub_type 和具体事件特定的字段,如果没有给出 sub_type,则该字段值可以为空字符串。

元事件是 OneBot 实现内部自发产生的一类事件,例如心跳等,与 OneBot 本身的运行状态有关,与实现对应的机器人平台无关。

meta.heartbeat 心跳

建议 OneBot 实现提供的配置项

  • enabled:是否启用心跳
  • interval:心跳间隔,单位:毫秒,必须大于 0

本页后续将使用 配置项名称<配置项名称> 的形式引用上述配置项的内容。

enabled 配置为 true 时,OneBot 实现应该每隔 interval 产生一个心跳事件。

建议 HTTP 通信方式忽略该类事件。

字段名 数据类型 说明
detail_type string 必须为 heartbeat
interval int64 到下次心跳的间隔,单位:毫秒
status resp[get_status] OneBot 状态,与 get_status 动作响应数据一致
{
    "id": "b6e65187-5ac0-489c-b431-53078e9d2bbb",
    "impl": "go_onebot_qq",
    "platform": "qq",
    "self_id": "123234",
    "time": 1632847927,
    "type": "meta",
    "detail_type": "heartbeat",
    "sub_type": "",
    "interval": 5000,
    "status": {
        "good": true,
        "online": true
    }
}