好友事件
自身状态变更
FRIEND_EVENT_SELF_STATUS_CHANGED("self_status_changed"):Bot 自身资料状态变化。
通过 on_friend_event 推送,event_type 为 FRIEND_EVENT_SELF_STATUS_CHANGED("self_status_changed")。仅表示资料状态同步,不代表网络连接状态变化。
参与人字段
operator_*:Bot 自身。target_user_id = 0、target_nickname = ""。
data 字段
{ "status": 6, "ext_status": 0 }| 字段 | 类型 | 说明 |
|---|---|---|
status | uint32 | 资料状态 PROFILE_STATUS_*(与 ACCOUNT_* 不同) |
ext_status | uint32 | 仅当 status == PROFILE_STATUS_ONLINE 时有效,其他情况下为 0 |
PROFILE_STATUS_* 常量
| 常量 | 值 | 说明 |
|---|---|---|
PROFILE_STATUS_ONLINE | 1 | 在线 |
PROFILE_STATUS_OFFLINE | 2 | 离线 |
PROFILE_STATUS_AWAY | 3 | 离开 |
PROFILE_STATUS_INVISIBLE | 4 | 隐身 |
PROFILE_STATUS_BUSY | 5 | 忙碌 |
PROFILE_STATUS_QME | 6 | Q我吧 |
PROFILE_STATUS_DND | 7 | 请勿打扰 |
可能收到尚未列出的值,请保留原值或按未知状态显示。
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 |