跳转到正文
群聊消息

图片

群聊消息中的 image 消息段字段说明与发送复用规则。

群聊消息中的图片消息段,type 为 "image",收发均支持。

image 字段说明

字段类型说明
file_idstring图片文件标识
namestring文件名
md5string图片 MD5
sha1string图片 SHA-1
sizeuint64文件大小(字节)
widthuint64图片宽度(像素)
heightuint64图片高度(像素)
pic_typeuint64图片类型值
originalbool是否为原图
urlstring图片地址;上传结果中为空字符串,不影响发送,发送时不参与下载或上传

群聊发送说明

  • 通过 upload_group_image 上传成功后,返回只含一条 image 消息段的 JSON 数组;上传返回的 image.data.url 为空字符串,不影响直接传给 send_group_message 发送。
  • 发送图片时须使用同一账号、平台和群,并具备 send_group_message 权限。

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[])

本页目录