Skip to content

elementType 3 — 文件 ​

对应 WeQ 解析实现:packages/codec/src/proto/msg/element.ts(elementType = 3)。

通用文件传输。大量复用「文件族」共用 tag,共用部分见 40800 总览 · 第五节。


一、复用自文件族的字段 ​

tag字段名说明
45402fileName文件名
45403filePath本地路径
45405fileSize字节数
45406md5Bytes二进制 MD5
45408contentHash内容校验 hash
45411 / 45412imgWidth / imgHeight宽高(图片类文件才有意义)
45415fileFlag45415文件相关标识
45503fileToken下载凭据
45504transferFlag45504传输标志(string)
45505uploadTime上传 / 处理时间戳
45510videoToken下载 token
45511picTransferState传输状态
45513transferVersion传输版本
45550transferState传输状态

45510 曾被误标为 fileFlag45510,实为下载 token,VIDEO 与 FILE 共用。

二、FILE 专属字段 ​

必有 ​

tag字段名类型含义
45003subTypeuint32文件类型判别式,观测到约 20 种取值,尚未逐一映射(代码里留有 FileSubType 的 TODO)
45407md5Bytes2bytes第二份 MD5,形状与作用同 45406
45409fileFlag45409bytes未知字节串
45501fileFlag45501uint32未知整数(可能是 bool)
45512fileFlag45512bool未知布尔标志
45514fileFlag45514bool未知布尔标志

可选 ​

tag字段名类型含义
45554transferErrorTextstring人类可读的传输错误,如「传输失败,请稍后重试」
45533fileFlag45533uint32仅在一条 subType=4 的行上观测到(值为 2)
45951fileThumbPathRemotestring发送端的缩略图路径(手机端,.thumbnails/…)
45953fileThumbPathRemote2string发送端的第二个缩略图路径(qlarge-dsc-…)
45954fileThumbLocalPathstring本机缓存的缩略图路径(nt_data/File/Thumb/…)
45966fileFlag45966bytes所有观测行均为空
45967fileFlag45967bytes所有观测行均为空
45968fileGroupMetabytes群文件元数据块(上传者 uin / 昵称、文件 uuid、上传时间…)。仅观测到一次,子 tag 未验证,故保留为原始字节
45507 / 45509传输标记见总览

← 返回消息段索引

当前文档对应 v2.7.4 · 已发布内容以 CHANGELOG 为准