跳转到正文
好友消息

图片

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

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

image 字段说明

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

好友发送说明

  • 通过 upload_friend_image 上传成功后,返回只含一条 image 消息段的 JSON 数组;上传返回的 image.data.url 为空字符串,不影响直接传给 send_friend_message 发送。
  • 发送已有好友图片时,可将收到的好友消息中的 image 消息段原样放入数组;需有效的新版图片 file_id,不支持旧版图片引用;url 不参与发送,不会下载或上传文件。

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 的备注,其次昵称;未取到时为 ""

本页目录