好友消息
闪照
好友消息中的 flash_image 消息段字段说明与 reference 原样保留要求。
好友消息中的闪照消息段,type 为 "flash_image",收发均支持。
flash_image 字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
name | string | 文件名 |
size | uint64 | 文件大小(字节) |
type | uint64 | 图片类型值 |
md5 | string | 图片 MD5 |
width | uint64 | 图片宽度(像素) |
height | uint64 | 图片高度(像素) |
url | string | 图片地址;上传结果中为空字符串,不影响发送 |
reference | object(可选) | 不透明图片引用对象;发送时须原样保留上传或接收结果中的值,不要自行构造 |
好友发送说明
- 通过
upload_friend_flash_image上传成功后,返回只含一条flash_image消息段的 JSON 数组;上传返回的url为空,不影响直接发送。 - 闪照不支持原图选项。
- 发送时必须保留上传结果中的
flash_image.data.reference,不要自行构造;收到的闪照消息段同样携带reference。 - 成功后须使用同一账号、平台和好友,将
result->message原样传给send_friend_message(需send_friend_message权限)。
FriendMessage 公共字段
| 字段 | 类型 | 说明 |
|---|---|---|
self_id | uint64_t | 收到消息的 Bot 账号 |
platform | const char * | 所属平台 PLATFORM_* |
user_id | uint64_t | 发送人 QQ 号 |
msg_seq | uint64_t | 消息序号 |
msg_uid | uint64_t | 消息唯一编号 |
random | uint64_t | 消息随机数 |
msg_time | uint64_t | 发送时间(Unix 秒) |
message | const char * | 消息段 UTF-8 JSON 数组(Segment[]) |
nickname | const char * | 好友显示名:优先本 Bot 的备注,其次昵称;未取到时为 "" |