跳转到正文
群聊事件

成员减少 / 解散

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_iduint64_t接收事件的 Bot 账号
platformconst char *所属平台 PLATFORM_*
event_typeconst char *事件类型 GROUP_EVENT_*
event_timeuint64_t事件时间(Unix 秒)
dataconst char *对应事件类型的 UTF-8 JSON 字符串
operator_nicknameconst char *主动人显示名(优先备注),未取得为 ""
operator_user_iduint64_t主动人 QQ 号,未取得或不适用时为 0
target_nicknameconst char *被动人显示名(优先备注),未取得为 ""
target_user_iduint64_t被动人 QQ 号,未取得或不适用时为 0
group_iduint64_t群号
group_nameconst char *群名称,未取得为 ""

本页目录