跳转到正文
好友消息

公共字段

通过 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_iduint64_t收到消息的 Bot 账号
platformconst char *所属平台 PLATFORM_*
user_iduint64_t发送人 QQ 号
msg_sequint64_t消息序号
msg_uiduint64_t消息唯一编号
randomuint64_t消息随机数
msg_timeuint64_t发送时间(Unix 秒)
messageconst char *消息段 UTF-8 JSON 数组(Segment[])
nicknameconst char *好友显示名:优先本 Bot 的备注,其次昵称;未取到时为 ""

消息段子类型

type说明发送支持
text文本支持
face表情支持
image图片支持
flash_image闪照支持
video短视频支持(单独发送)
voice语音支持(单独发送)
reply回复仅接收
forward合并转发支持
redpack红包仅接收
unknown未知消息段仅接收

本页目录