群聊事件
成员减少 / 解散
GROUP_EVENT_MEMBER_DECREASED("member_decreased"):成员退群、被移出或群聊解散。
通过 on_group_event 推送,event_type 为 GROUP_EVENT_MEMBER_DECREASED("member_decreased")。
data 与参与人字段
{ "reason": "kick" }data.reason | 含义 | operator_* | target_* |
|---|---|---|---|
"leave" | 主动退群 | 退群成员(operator_user_id == self_id 表示 Bot 自身退群) | 0 / "" |
"kick" | 成员被移出 | 执行移除的人(无法确认时为 0 / "") | 被移出成员(target_user_id == self_id 表示 Bot 自身被移出) |
"disband" | 群聊解散(影响整个群,不逐个列出成员) | 仅在能确认解散操作者时提供,否则为 0 / "" | 0 / "" |
资料未能取得时,账号或昵称仍可为 0 或 "",不影响事件通知。
GroupEvent 公共字段
| 字段 | 类型 | 说明 |
|---|---|---|
self_id | uint64_t | 接收事件的 Bot 账号 |
platform | const char * | 所属平台 PLATFORM_* |
event_type | const char * | 事件类型 GROUP_EVENT_* |
event_time | uint64_t | 事件时间(Unix 秒) |
data | const char * | 对应事件类型的 UTF-8 JSON 字符串 |
operator_nickname | const char * | 主动人显示名(优先备注),未取得为 "" |
operator_user_id | uint64_t | 主动人 QQ 号,未取得或不适用时为 0 |
target_nickname | const char * | 被动人显示名(优先备注),未取得为 "" |
target_user_id | uint64_t | 被动人 QQ 号,未取得或不适用时为 0 |
group_id | uint64_t | 群号 |
group_name | const char * | 群名称,未取得为 "" |