跳转到正文
好友事件

公共字段

通过 on_friend_event 接收好友事件的公共结构体与事件类型列表。

好友事件通过可选导出函数 on_friend_event 接收(Bot 自身资料状态的跨端同步也归入好友事件,不表示连接或登录状态变化)。好友事件不受好友聊天消息开关控制,也不计入聊天消息接收数。

EXPORT void on_friend_event(const FriendEvent *event);

在昵称或备注变更事件中,operator_nickname / target_nickname 可能仍是变更前的显示名,具体新值以 data 为准。

FriendEvent 公共字段

字段类型说明
self_iduint64_t接收事件的 Bot 账号
platformconst char *所属平台 PLATFORM_*
event_typeconst char *事件类型 FRIEND_EVENT_*
event_timeuint64_t服务端事件时间(Unix 秒)
dataconst char *对应事件类型的 UTF-8 JSON 字符串
operator_nicknameconst char *主动者显示名(优先备注,其次昵称),无可用名时为 ""
operator_user_iduint64_t主动者 QQ 号
target_nicknameconst char *被动者显示名(优先备注),不适用时为 ""
target_user_iduint64_t被动者 QQ 号,不适用时为 0

事件子类型

常量event_type 值说明
FRIEND_EVENT_SELF_STATUS_CHANGED"self_status_changed"自身状态变更
FRIEND_EVENT_NICKNAME_CHANGED"nickname_changed"昵称变更
FRIEND_EVENT_REMARK_CHANGED"remark_changed"备注变更
FRIEND_EVENT_DELETED"friend_deleted"好友关系移除
FRIEND_EVENT_REQUEST"friend_request"好友申请

本页目录