跳转到正文
好友消息

闪照

好友消息中的 flash_image 消息段字段说明与 reference 原样保留要求。

好友消息中的闪照消息段,type 为 "flash_image",收发均支持。

flash_image 字段说明

字段类型说明
namestring文件名
sizeuint64文件大小(字节)
typeuint64图片类型值
md5string图片 MD5
widthuint64图片宽度(像素)
heightuint64图片高度(像素)
urlstring图片地址;上传结果中为空字符串,不影响发送
referenceobject(可选)不透明图片引用对象;发送时须原样保留上传或接收结果中的值,不要自行构造

好友发送说明

  • 通过 upload_friend_flash_image 上传成功后,返回只含一条 flash_image 消息段的 JSON 数组;上传返回的 url 为空,不影响直接发送。
  • 闪照不支持原图选项。
  • 发送时必须保留上传结果中的 flash_image.data.reference,不要自行构造;收到的闪照消息段同样携带 reference。
  • 成功后须使用同一账号、平台和好友,将 result->message 原样传给 send_friend_message(需 send_friend_message 权限)。

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

本页目录