好友消息
短视频
好友消息中的 video 消息段字段说明与复用发送限制。
好友消息中的短视频消息段,type 为 "video"。
video 字段说明
好友和群聊短视频均使用 video 段,正片和封面均不包含 URL。
| 字段 | 类型 | 说明 |
|---|---|---|
file_id | string | 文件标识 |
name | string | 文件名,缺失时为 "" |
md5 | string | MD5,缺失时为 "" |
sha1 | string | SHA-1,缺失时为 "" |
size | uint64 | 字节数,缺失时为 0 |
width | uint64 | 宽度(像素),缺失时为 0 |
height | uint64 | 高度(像素),缺失时为 0 |
duration | uint64 | 时长(秒),缺失时为 0 |
video_codec | uint64(可选) | 0 为 H.264,1 为 H.265;未提供时省略 |
thumbnail | ThumbnailData(可选) | 封面对象;未提供时省略 |
封面 ThumbnailData
包含 file_id、name、md5、sha1、size、width、height,字段类型与缺失规则同正片,不包含 URL。
好友复用发送限制
- 发送已有好友视频时,消息数组必须只含一条好友
video消息段(取自收到的好友消息或upload_friend_video返回的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 的备注,其次昵称;未取到时为 "" |