好友事件
公共字段
通过 on_friend_event 接收好友事件的公共结构体与事件类型列表。
好友事件通过可选导出函数 on_friend_event 接收(Bot 自身资料状态的跨端同步也归入好友事件,不表示连接或登录状态变化)。好友事件不受好友聊天消息开关控制,也不计入聊天消息接收数。
EXPORT void on_friend_event(const FriendEvent *event);在昵称或备注变更事件中,operator_nickname / target_nickname 可能仍是变更前的显示名,具体新值以 data 为准。
FriendEvent 公共字段
| 字段 | 类型 | 说明 |
|---|---|---|
self_id | uint64_t | 接收事件的 Bot 账号 |
platform | const char * | 所属平台 PLATFORM_* |
event_type | const char * | 事件类型 FRIEND_EVENT_* |
event_time | uint64_t | 服务端事件时间(Unix 秒) |
data | const char * | 对应事件类型的 UTF-8 JSON 字符串 |
operator_nickname | const char * | 主动者显示名(优先备注,其次昵称),无可用名时为 "" |
operator_user_id | uint64_t | 主动者 QQ 号 |
target_nickname | const char * | 被动者显示名(优先备注),不适用时为 "" |
target_user_id | uint64_t | 被动者 QQ 号,不适用时为 0 |