群聊事件
公共字段
通过 on_group_event 接收群聊事件的公共结构体与事件类型列表。
群聊事件通过可选导出函数 on_group_event 接收,不受群聊消息开关控制,也不计入聊天消息接收数。所有字符串字段均非 NULL,仅在回调期间有效,异步或稍后使用必须先复制。
EXPORT void on_group_event(const GroupEvent *event);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 * | 群名称,未取得为 "" |