跳转到正文
群聊消息

公共字段

通过 on_group_message 接收群聊消息的公共结构体与消息段类型列表。

on_group_message 为可选导出函数。未导出时,主程序不会向插件投递群聊消息。

EXPORT void on_group_message(const GroupMessage *message);

使用约定

  • 结构体及所有字符串字段均非 NULL,且仅在本次回调期间有效;如需在工作线程或稍后使用,必须先复制所需字段。
  • message 字段为 UTF-8 JSON 数组,每项为 {"type": "类型", "data": {...}};接收时应容忍未知类型和字段,不要用浮点数保存 64 位整数。
  • 回调应尽快返回,不要将收到的 GroupMessage 字段与调用 send_group_message 返回的 SendResult 混用。

GroupMessage 公共字段

字段类型说明
self_iduint64_t收到消息的 Bot 账号
platformconst char *所属平台 PLATFORM_*
group_iduint64_t群号
user_iduint64_t发送人 QQ 号
msg_sequint64_t消息序号
msg_uiduint64_t消息唯一编号
randomuint64_t消息随机数
msg_timeuint64_t发送时间(Unix 秒)
leveluint64_t发送人的群成员等级,没有时为 0
group_nameconst char *群名称
nicknameconst char *发送人昵称(设置了群名片时为群名片)
roleconst char *发送人身份:"owner" 群主、"admin" 管理员、"member" 成员
titleconst char *发送人头衔,没有时为 ""
messageconst char *消息段 UTF-8 JSON 数组(Segment[])

消息段子类型

type说明发送支持
text文本支持
at@ 某人支持
at_all@ 全体成员支持
face表情支持
image图片支持
video短视频支持(单独发送)
voice语音支持(单独发送)
reply回复仅接收
forward合并转发支持
redpack红包仅接收
unknown未知消息段仅接收

本页目录