跳转到正文
群聊事件

公共字段

通过 on_group_event 接收群聊事件的公共结构体与事件类型列表。

群聊事件通过可选导出函数 on_group_event 接收,不受群聊消息开关控制,也不计入聊天消息接收数。所有字符串字段均非 NULL,仅在回调期间有效,异步或稍后使用必须先复制。

EXPORT void on_group_event(const GroupEvent *event);

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 *群名称,未取得为 ""

事件子类型

常量event_type 值说明
GROUP_EVENT_ADMIN_CHANGED"admin_changed"管理员变更
GROUP_EVENT_MEMBER_INCREASED"member_increased"成员入群
GROUP_EVENT_MEMBER_DECREASED"member_decreased"成员减少 / 解散
GROUP_EVENT_REQUEST"group_request"群请求
GROUP_EVENT_REQUEST_REFUSED"group_request_refused"入群申请被拒

本页目录