好友消息
公共字段
通过 on_friend_message 接收好友消息的公共结构体与消息段类型列表。
on_friend_message 为可选导出函数。未导出时,主程序不会向插件投递好友消息。
EXPORT void on_friend_message(const FriendMessage *message);使用约定
- 结构体及所有字符串字段均非
NULL,且仅在本次回调期间有效;如需在工作线程或稍后使用,必须先复制所需字段。 message字段为 UTF-8 JSON 数组,每项为{"type": "类型", "data": {...}};接收时应容忍未知类型和字段,不要用浮点数保存 64 位整数。- 回调应尽快返回,不要将收到的
FriendMessage字段与调用send_friend_message返回的SendResult混用。
FriendMessage 公共字段
| 字段 | 类型 | 说明 |
|---|---|---|
self_id | uint64_t | 收到消息的 Bot 账号 |
platform | const char * | 所属平台 PLATFORM_* |
user_id | uint64_t | 发送人 QQ 号 |
msg_seq | uint64_t | 消息序号 |
msg_uid | uint64_t | 消息唯一编号 |
random | uint64_t | 消息随机数 |
msg_time | uint64_t | 发送时间(Unix 秒) |
message | const char * | 消息段 UTF-8 JSON 数组(Segment[]) |
nickname | const char * | 好友显示名:优先本 Bot 的备注,其次昵称;未取到时为 "" |