跳转到正文
好友消息

短视频

好友消息中的 video 消息段字段说明与复用发送限制。

好友消息中的短视频消息段,type 为 "video"。

video 字段说明

好友和群聊短视频均使用 video 段,正片和封面均不包含 URL。

字段类型说明
file_idstring文件标识
namestring文件名,缺失时为 ""
md5stringMD5,缺失时为 ""
sha1stringSHA-1,缺失时为 ""
sizeuint64字节数,缺失时为 0
widthuint64宽度(像素),缺失时为 0
heightuint64高度(像素),缺失时为 0
durationuint64时长(秒),缺失时为 0
video_codecuint64(可选)0 为 H.264,1 为 H.265;未提供时省略
thumbnailThumbnailData(可选)封面对象;未提供时省略

封面 ThumbnailData

包含 file_id、name、md5、sha1、size、width、height,字段类型与缺失规则同正片,不包含 URL。

好友复用发送限制

  • 发送已有好友视频时,消息数组必须只含一条好友 video 消息段(取自收到的好友消息或 upload_friend_video 返回的 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 的备注,其次昵称;未取到时为 ""

本页目录