pure_live Windows 虎牙长录制验收实录:多段 TS 录制、MP4 合并与完整性证据链解析

原创2026-10-14 20:57:221,953 阅读
文章标签:音视频直播跨平台移动开发桌面应用

pure_live Windows 虎牙长录制验收实录:多段 TS 录制、MP4 合并与完整性证据链解析

本篇技术指南围绕 pure_live(Windows x64 Release 3.1.8+4121 候选)在虎牙直播间进行的约 12 分钟长录制验收展开,完整记录了一次真实录制的操作步骤、分段切片机制、多段合并为 MP4 的实现原理、产物媒体指标与性能资源观测,并结合仓库源码剖析 segment muxer、clock-v1 时间戳账本、RecorderLease 预取续接策略等底层实现。读者读完可以掌握 pure_live 录制中心从"开始录制→分片落盘→停止合并→产物校验"的完整链路,以及如何用 FFmpeg 逐包 DTS、完整解码等手段验证长录制文件的时间戳连续性与完整性。

验收背景与候选环境

本次验收针对 3.1.8+4121(unsigned) 的 Windows x64 Release 候选,复用 2d8e4e0c Release 候选 的构建产物,未进行源码修改、重新构建、全量测试、版本递增或发布。验收使用独立实例 record_release_2d8e4e0c、PID 31316,与主实例数据隔离,避免插件偏好、历史设置干扰录制结果;开始时仓库 HEAD 为文档提交 7e063dda。

验收遵守了明确的边界约束:

  • 手机身份仅做只读核对(25102RKBEC / myron),当前前台仍为 Bilibili,未抢占输入、未安装或修改 MT/Root/LSP;
  • 未删除测试产生的录制文件或用户数据;
  • 全部动作限定在候选实例的隔离目录中,最终录制产物保留在 AppData/record_release_2d8e4e0c/RECORDS/ 下。

这类"独立实例 + 只读外围 + 保留证据"的隔离做法,是 pure_live 验收体系(见 Windows 候选与空闲 CPU 验收)的标准流程:候选构建、便携解压、独立启动、分段采样、正常退出,全程不污染主资料。

录制过程实操:从进入直播间到停止合并

验收在虎牙热门页进入 胖炸 / 84进80【联合巅峰赛】龙凤店 直播间,播放器和录制中心均显示 蓝光20M、线路1。视频画面与远端弹幕在开始、中途、十分钟后的截图中持续变化,证明录制期间的直播源是活跃的;本轮未做听音验收。

时间轴关键节点(UTC):

事件 时间点
开始录制点击 05:12:20.1946027Z
成功停止点击 05:24:06.269Z
点击墙钟差 706.0743973 秒
应用正常退出 05:28:37.9885035Z

值得注意的实操细节:此前一次 AX(无障碍)停止操作因缓存元素失效未执行,被单独记为失败尝试;验收者重新观察界面后通过实际坐标完成停止,且不把失败尝试时间当作成功停止时间。这说明 Windows 自动化验收中,控件句柄失效是常见问题,点击成功与否必须与操作结果核对,而不能只看"是否发起了点击"。

录制中心的状态序列:

  • 00:10:53 → 160.41 MB(片段正在增长)
  • 00:11:03 → 163.91 MB
  • 00:11:37 → 174.16 MB
  • 停止时"处理中" 00:11:51 / 178.94 MB
  • 随后"已停止" 00:11:51 / 168.92 MB

从"处理中 178.94 MB"变为"已停止 168.92 MB",正是多段 TS 源文件被合并、清理后的产物尺寸;卡片上展示的是合并后 MP4 的最终大小。

停止后返回播放器,视频和弹幕立即恢复,随后退出直播间回到虎牙热门列表;资源采样完成后 Alt+F4 触发退出确认,PID 消失,应用正常结束。

分段录制机制:segment muxer 与五分钟切片

录制中途观察到的文件增长揭示了分段结构:十分钟后有同一前缀的 _000000.ts、_000001.ts、_000002.ts 三个文件段,停止后合并为单个 MP4。文档明确指出:这些五分钟文件段不是签名续接次数的证据,它们只是 FFmpeg segment muxer 按固定时长切分的产物。

在源码中,分段时间由 RecorderConfig 管理:

static const defaultSegmentTime = 300;   // 默认 300 秒,即 5 分钟一段
static const minSegmentTime = 60;
static const maxSegmentTime = 3600;

用户可通过录制设置修改 segmentTime,取值范围被钳制在 60~3600 秒(见 normalizeSegmentTime),默认值 300 秒与本次验收观察到的五分钟片段完全吻合。

实际写盘命令由 FFmpegCommandBuilder.buildRecordArguments 构建,其核心参数如下:

FFmpeg 参数 取值 作用
-f segment mpegts 使用 segment muxer 输出 MPEG-TS 分段
-segment_format mpegts — 每个子段容器为 MPEG-TS
-segment_time segmentTime.clamp(10, 86400) 每段目标时长(秒)
-segment_list {prefix}.clock-v1.csv 段列表(CSV 日志)
-segment_list_type csv — 段列表格式
-segment_start_number 0 — 段序号从 0 开始
-reset_timestamps 1 — 每段重置时间戳基准
-segment_format_options flush_packets=1:avoid_negative_ts=disabled:max_delay=0:output_ts_offset=1.4 每段即时落盘、保留音频包时间戳锚点、显式保留 1.4 秒前置时间
-n — 不覆盖已有输出
-map 0:v:0? / 0:a:0? — 视频/音频可选映射,兼容纯音频房间
-c copy — 流复制,不重编码
-dts_delta_threshold / -dts_error_threshold 2 仅对网络输入启用,修正 CDN 时间戳跳变
-reconnect / -reconnect_streamed / -reconnect_on_http_error 5xx — HTTP 源断线自动重连(仅对 5xx 服务端错误重试)

文件名遵循 clock-v1 规范:{时间戳前缀}_%06d.clock-v1.ts,时间戳前缀形如 20260907_131221_058,由 RecordingSegmentClock 统一生成与校验。该组件定义了段后缀 .clock-v1.ts、CSV 日志名 {prefix}.clock-v1.csv,并严格校验 CSV 行数等于实际段数、段名与序号匹配、起始时间单调递增;缺失或畸形的日志会在合并前直接失败,绝不会把残缺段当完整录制合并。

此外,RecordingClockReservation 在启动 FFmpeg 前先做输出预留:校验输出模式必须是以 _%06d.clock-v1.ts 结尾、校验 CSV 日志路径与命令一致、拒绝同进程重复激活、拒绝已存在的日志或段文件。这就是"停止后合并"能安全进行的前提——同一前缀只存在一份完整、有序的段集合。

多段合并:ffconcat 清单与 MP4 原子提交

停止录制后,VideoProcessorService.convertToMp4 负责把全部 .clock-v1.ts 段合并为单个 MP4。合并流程分为几步:

  1. 目录快照与段选择:扫描输出目录中的 .ts 文件,用 selectAttemptSegments 按 {filePrefix}_\d{6,}(\.clock-v1)?\.ts 精确挑选本次尝试的段,杜绝把其他尝试或旧格式文件混入;
  2. clock-v1 日志校验:读取 CSV 日志,验证段数、段名、时间戳顺序,生成 ffconcat 清单(每段 file '...' + inpoint 0 + 按起始时间差计算 duration),见 RecordingSegmentClock.toConcatManifest;
  3. 原生合并:以 -f concat -safe 0 -i {清单} -map 0:v? -map 0:a? -c copy -movflags +faststart -f mp4 输出到 .partial 临时文件,全程流复制不重编码;-xerror 让解封装/封装错误直接判失败,避免 FFmpeg 部分版本返回 0 的误判;
  4. 原子提交:临时文件经 rename 原子地变为最终 {prefix}.mp4(重命名是唯一的提交点,提交前再次检查取消状态),随后才删除源 TS 段与 CSV 日志;若某段被系统锁定无法删除,则保留日志以便精确恢复。

合并超时也做了动态设计:mergeTimeout 不再使用固定 5 秒,而是以"8 MiB/s 字节下限 + 20 秒 + 时长/20 秒"三者取最大值,并钳制在 30~3600 秒之间——长录制文件大、段数多,固定短超时会把健康的长录制误判失败并取消 MP4 收尾(源码注释明确记录了这一演进)。

最终文件为候选实例 AppData/record_release_2d8e4e0c/RECORDS/huya/胖炸/2026-09-07/13-12-21/20260907_131221_058.mp4。目录结构 RECORDS/{平台}/{主播}/{日期}/{时分秒}/ 由 CacheService.getRoomDir 生成,支持拼音/昵称两种目录命名策略(usePinyinForFolder)。

产物媒体指标:完整性证据链

合并后的 MP4 接受了完整的媒体级核验,结果如下:

指标 实测值
最终大小 177,121,160 B = 168.915901 MiB,录制卡片两位小数 168.92 一致
SHA-256 B641EB6E35215BD96E682B5839A025024260A95A5C30E64F3190E7CDAA1B1E64
容器时长 711.805833 秒
视频流 H.264 High,1280×720,标称 60 fps,42,703 帧,时长 711.774833 秒
音频流 AAC LC,44.1 kHz 双声道,30,652 帧,时长 711.796077 秒
完整解码 本机 FFmpeg -threads 2 全部音视频解码退出码 0,错误日志 0 B
逐包 DTS 视频/音频非正间隔均 0、>2 秒间隔均 0;最大间隔 0.046989 / 0.053220 秒

这两组逐包 DTS 与完整解码数据是"长录制无丢帧、时间戳连续"的最有力证据:非正间隔为 0 意味着不存在时间戳倒退或重复,>2 秒间隔为 0 意味着不存在长停顿,而全部解码退出 0 且错误日志 0 B 意味着整个文件可以被完整解码。

一个容易被误解的点被文档明确纠正:画质名称"20M"不等于固定分辨率或实测码率。该文件实际为 720p,约 1.99 Mbps 总码率。直播平台的"蓝光20M"只是档位标签,真实分辨率与码率由源端决定,验收时必须以 ffprobe/解码实测为准。

时间偏差方面:媒体时长(711.805833 秒)比起止点击墙钟(706.0743973 秒)多约 5.731 秒,与之前短样本的方向一致。文档对此保持了严格的证据边界:源端预缓冲与起止记录开销尚未分离验证,不声称精确墙钟等长或零丢帧——即这 5.7 秒既可能是进入直播间时源端的预缓冲,也可能是点击开始/停止的 UI 操作开销,二者尚未独立量化。

性能与资源观测

录制全程使用既有只读采样器(24 逻辑核归一 CPU,未采样 GPU),录制段停留在播放器页内,未在采样中切换菜单或录制中心;解码验证在离页采样开始前已结束,避免解码进程干扰 CPU 测量。采样脚本可参考 tool/sample_windows_runtime.ps1。

场景 时长/响应 CPU 均值 / P95 Working Set 首→末 MiB Private Bytes 首→末 MiB 句柄/线程 首→末
Release 播放+弹幕+录制 600.646 秒,61/61 4.3918% / 4.8676% 400.7891→444.5234(峰 455.7344) 872.2617→845.6562 1762→1747 / 251→244
离页后虎牙热门 60.574 秒,13/13 2.5173% / 2.7133% 403.2578→335.5781 980.4531→711.2969 1687→1326 / 237→155

结论分两层:

  • 录制期间 CPU 均值约 4.39%,P95 约 4.87%,处于低位;Working Set 随录制文件增长有自然上升(峰值 455.73 MiB);
  • 离页回到列表后,内存、句柄、线程均有实际回落(Working Set 降至 335.58 MiB、Private Bytes 降至 711.30 MiB、句柄 1687→1326、线程 237→155),说明资源能够释放。

但列表页 CPU 仍约 2.5%,文档不标记性能 PASS。此前 同步无障碍查询干扰 尚未排除,本轮也没有仪表测量查询率,因此这些数值被定性为"当前桌面环境下的实测值",不是无干扰基准,也不归因于某个观察工具,更不能直接与不同直播内容的 Debug 数值比较。两个采样会话及完整解码均退出 0,应用正常退出记录为 05:28:37.9885035Z;未终止其他任务、服务或桌面进程。

签名续接与租约策略:本轮未闭环的部分

文档对验收边界极其克制。当前 recorder_controller.dart 对 native WUP FLV 在健康连接上仅预取后续凭据,不为刷新定时器主动切流;其余租约保留轮换策略。

从源码结构看,续接机制由三部分组成:

  • _scheduleRecorderLeaseRefresh:在平台刷新边界前安排租约刷新,成功后把新凭据存入 _prefetchedRecorderLeases 内存缓存,不打断正在播放/录制的长连接;
  • _prefetchRecorderLease:实际发起预取请求,用 _RecorderLeasePrefetch 标记防止并发重复请求,失败时按 RecorderContinuationPolicy.leaseMaintenanceDelay 限流(最小 30 秒一次);
  • _PendingRecorderLease:在快速恢复场景中,若预取凭据仍有效(invalidAt 未过期且 URL 与当前一致)则直接复用,否则重新走 StreamResolverService 解析。

相关策略集中在 RecorderContinuationPolicy:leasePrefetchDelay 默认提前 5 秒获取替换凭据;leaseRotationDelay 对已迟到的定时器立即补偿;shouldRetryFailure 对 CDN I/O 错误(含 HTTP 403/404、av_interleaved_write_frame 之外的非致命错误)允许重新解析 URL 并重启录制;reconnectDelay 对 unexpected EOF 使用 2 秒基数、15 秒上限的快速重连;shouldEnterPollingAfterRetryLimit 在重试预算耗尽后转入轮询等待下一场直播,而不是无限撞击 CDN 留下空段破坏合并。

与 EOF 判定配套的是 FFmpegTerminalDecision.forSession:对 live recording,输入侧 code == 0 或 AVERROR_EOF(-541478725)被判定为 retryable + unexpectedEof,而不是"主播下播"——因为直播录制没有自然的成功 EOF,CDN 响应结束意味着需要刷新签名 URL。

本轮验收的证据边界是明确的:

  • 本 Release 标准输出没有可验证的 RecorderLease 预取成功链,因此 ≥10 分钟录制及多段合并完整性子项完成,两次签名预取/续接仍待独立补证;
  • 未模拟断网、下播或恢复场景;
  • 本地忽略目录 local-artifacts/windows-long-record-2d8e4e0c-20260907/ 保留进程/起止/增长/退出 JSON、原始日志、两组 CSV 及汇总、ffprobe、逐包结果、文件哈希和完整解码结果。

验收账本与遗留项

本轮在验收账本中为 W3-05 增加了当前 Release 长录子证据,但该大项保持 RUN。其余平台、Android 长录、窗口/PiP/音频组合、DLNA、设置/数据、性能和全平台交付继续推进。历史账本仍为 20 PASS / 32 RUN / 10 NR,42 个大项未闭环——文档明确反对"以一个平台的一次长录替代全目标"。

对希望复现这套验收方法的开发者,可关注仓库内的合成回归测试:

  • recorder_segment_clock_probe_test.dart:用 av_cfr(定帧率)、av_vfr(变帧率)、video_only、audio_only 四种夹具对 clock-v1 路径做原生回归,比较 single(单段)、legacy(旧时钟)、productionSingle(生产单段)、candidate(分段)之间的帧内容与节奏一致性;
  • recorder_clock_retained_probe_test.dart:对保留的 framemd5 证据做精确有理数时钟复核,要求分段候选与单段的视频偏移不超过 2/90000 秒、音频不超过 2/44100 秒;
  • test_recording_clock_matrix_generator.py:生成时钟矩阵测试用例。

总结

本次 Windows Release 虎牙长录制验收给出了一个完整、可复核的闭环示例:独立候选实例下开始/停止录制 → segment muxer 按 300 秒默认值切出多个 .clock-v1.ts 段 → 停止后由 ffconcat 清单合并、原子提交为单个 MP4 → 以 ffprobe 指标、SHA-256、完整解码和逐包 DTS 四重证据确认产物连续性。同时它保持了严格的证据纪律:画质名不等于实测码率、媒体时长差 5.731 秒不归因、列表 CPU 2.5% 不标 PASS、签名预取/续接与断网恢复场景明确待补证。这种"测量什么、承认什么、不声称什么"的边界意识,与仓库中 FFmpegCommandBuilder、RecordingSegmentClock、VideoProcessorService、RecorderContinuationPolicy 的源码实现互为印证,共同构成了 pure_live 录制模块可靠性的完整证据链。

登录后查看全文
pure_live