Skip to content

elementType 21 — 通话记录 ​

对应 WeQ 解析实现:packages/codec/src/proto/msg/element.ts(elementType = 21)。 枚举定义:packages/codec/src/element/types.ts(CallType / CallSubType)。

音视频通话记录(QQ 内部名 AVRECORD):语音通话、视频通话、屏幕共享、远程协助的结果条目。

WARNING

私聊与群聊是两套结构,subType 的编号也不互通,详见第四节。


一、字段 ​

tag字段名类型必有含义
48151answerTypeuint32✅接听 / 挂断类型,与 subType 一致,取值见 CallSubType
48152durationuint32✅通话时长(毫秒),但旧版客户端写的是时间戳,见下方说明
48154callMethoduint32✅通话方式,见下表
48157callSummarystring(repeated)✅通话摘要文案
48153callFlag48153string协议标志(长度分隔)。实测恒等于 callSummary 去掉前缀后的正文
48155callUnknownTypeuint32未知类型标志。观测到 0 / 1 / 2 或缺失
48156callFlag48156uint32协议标志。可当作客户端世代标记:旧版写 0,新版写 1

WARNING

48152 的单位是毫秒,与语音元素的 45906(秒)不同。

duration 的世代差异(坑) ​

2025 年前后 QQ 重构过通话模块,48152 的语义跟着变了:

世代callFlag48156duration 实际内容callSummary 形态
旧版0unix 秒级时间戳(如 1726891067)带方式前缀:[语音通话] 通话时长 00:35
新版1毫秒时长(如 1001 = 00:01)无前缀:通话时长 00:01

所以不要直接拿 duration 格式化时长 —— 旧记录会算出荒谬的值。渲染一律优先用 QQ 已经排好版的 callSummary(WeQ 的 QqCall 就是这么做的)。

二、callMethod(48154) ​

值名称说明
0GROUP_ENDED群聊「通话已结束」提示,无方式字段;具体是语音还是视频只能看 subType
1VOICE语音通话
2VIDEO视频通话
3SCREEN_SHARE屏幕共享
5REMOTE_ASSIST远程协助

三、subType / answerType ​

45003 (subType)、48151 (answerType) 与消息行的 40012 列三者取值一致,合起来 描述「什么类型的通话、以什么方式结束」。

私聊(c2c_msg_table) ​

一条消息 = 一整通电话的最终状态,中间过程不落库。

值名称摘要文案说明
2VIDEO_ACCEPTED通话时长 xx:xx视频通话已接通
3VIDEO_REJECTED_BY_US未接听,点击回拨视频通话被本方拒绝
5VIDEO_ACCEPTED_LEGACY[视频通话] 通话时长 xx:xx视频接通,旧版客户端编号,语义同 2
6VIDEO_REJECTED_BY_PEER对方已拒绝视频通话被对方拒绝
7VOICE_ACCEPTED通话时长 xx:xx语音通话已接通
8VOICE_REJECTED_BY_US未接听,点击回拨语音通话被本方拒绝
9VOICE_PEER_NO_ANSWER对方未接听我方拨出、对方一直没接(旧版客户端)
10VOICE_CANCELED_BY_US已取消,点击重拨我方拨出后自己取消
11VOICE_REJECTED_BY_PEER对方已拒绝语音通话被对方拒绝
12VIDEO_HANDLED_OTHER_DEVICE已在其他设备处理视频通话已在其它设备处理
13VOICE_HANDLED_OTHER_DEVICE已在其他设备处理语音通话已在其它设备处理
19SCREEN_SHARE_ACCEPTED通话时长 xx:xx屏幕共享已接通
22SCREEN_SHARE_REJECTED对方未接听屏幕共享被拒绝
33REMOTE_ASSIST_ACCEPTED远程协助时长 xx:xx远程协助已接通
34REMOTE_ASSIST_FAILED已取消,点击重新发起远程协助失败

5 / 9 是旧版客户端才写的编号(callFlag48156 = 0),2025 年后的记录不再出现。 保留是为了历史消息能正确渲染。

群聊(group_msg_table) ​

拆成两条独立消息,中间状态(谁加入、谁离开、通了多久)一概不落库:

值名称callMethod40020(发送者)摘要文案
1GROUP_VOICE_STARTED1 (VOICE)发起人 uid发起了语音通话
26GROUP_VIDEO_STARTED2 (VIDEO)发起人 uid发起了视频通话
27GROUP_CLASSROOM_STARTED?发起人 uid发起了群课堂(直播)
16GROUP_VOICE_ENDED0空语音通话已结束
25GROUP_VIDEO_ENDED0空视频通话已结束
29GROUP_CLASSROOM_ENDED0空群课堂已结束

结束那条的 40020 / 40033 都是空的 —— 它不属于任何人,QQ 电脑端也把它画成居中 灰条。另外只有本机发起的通话才会写「发起」消息:别人在群里发起时本机只收得到 结束提示,所以历史记录里「结束」往往比「发起」多。

四、渲染约定(WeQ) ​

场景组件形态
私聊全部QqCall气泡内联:图标 + callSummary,失败/拒绝/未接标红
群聊「发起」(1/26)QqCall同上,气泡带发起人头像与昵称
群聊「已结束」(16/25)GroupCallEndedMessage居中灰条,无发送者

分流在 apps/desktop/src/renderer/src/im-template/template/chatPane.tsx 的 grayTipOf() 里:CALL 元素且 subType ∈ {16, 25} 的走灰条 band,其余照常走气泡。

五、排查工具 ​

用 WeQ 内置 MCP 的数据库工具(见 docs/guide/mcp-server.md):

text
# 看表的列
get_db_columns  { db: "msg.db", table: "group_msg_table" }

# 按 rowid 看整行
execute_sql     { db: "msg.db", sql: "SELECT * FROM group_msg_table WHERE rowid = <rowid>" }

# 统计 CALL 元素的 (40011, 40012) 组合
execute_sql     { db: "msg.db", sql: "SELECT \"40011\",\"40012\",COUNT(*) FROM group_msg_table GROUP BY \"40011\",\"40012\"" }

← 返回消息段索引

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