pure_live Windows 候选包虎牙播放与录制原生验收实录:切档、取直链、文件对账与资源回落全链路

原创2026-10-14 21:13:421,920 阅读
文章标签:音视频直播跨平台移动开发桌面应用

pure_live Windows 候选包虎牙播放与录制原生验收实录:切档、取直链、文件对账与资源回落全链路

本文是 pure_live 项目 Windows 端一次真实运行(原生验收)的技术复盘:在独立候选包 fadd5bdb(版本 3.1.8+4121,Debug/unsigned)上,通过 Computer Use 实际打开虎牙直播间,完成画质/线路切换、播放器"获取直链"对话框操作、录制中心启动与停止,并对最终 MP4 做字节对账、完整解码与逐包时间戳复核,同时用只读采样器采集了应用进程的 CPU、内存、句柄与线程走势。读完本文,你将掌握该仓库 Windows 录制链路"播放 → 切档 → 取直链 → 录制 → 收尾落盘"的验收方法、关键观测点,以及录制中心画质档位独立于播放器档位的底层实现原理。

验收背景:候选包、独立实例与只读约束

本轮补证复用了 fadd5bdb Windows Debug 候选 的构建产物:干净源码提交 fadd5bdb567d7b0ec856838079927a8cc5a8b27b,Windows x64 Debug / unsigned,版本 3.1.8+4121,而非 3.2.0 发布包。验收使用独立的 acceptance_fadd5bdb 数据目录,避免导入主实例旧配置。本轮没有应用代码修改、构建、完整重测或发布——它是对上一轮有效进展的延续,继续补齐真实运行缺口。

同时,验收保留了严格的只读纪律:

  • ADB 只读复核 25102RKBEC / myron 手机,明确指定 -s 192.168.1.2:5555;
  • 手机前台仍为 Bilibili,前两轮争用尚未协调,因此本轮未抢占或输入,继续在 Windows 侧推进;
  • 没有 MT、Root 或 LSP 改动。

实际播放:真实 UI 操作而非命令模拟

  • 独立 PID 77992,候选可执行文件路径/来源见本地 process.json;
  • 通过 Computer Use 操作窗口,实际截图尺寸 1276×718,不用命令模拟 UI;
  • Bilibili 热门加载后切换到虎牙,打开主播"杨齐家丶"的 【二台军师】3X3。实际视频首帧和远端弹幕均出现,后续截图中的直播内容与弹幕持续变化;本轮未做听音验收。

画质与线路切换:蓝光 20M → 8M、线路 1 → 2

在播放器内完成了两轮真实切换:

  1. 画质 蓝光20M → 蓝光8M;
  2. 线路 1 → 2。

UI 提交后播放器保持 8M/线路 2 不变;player-transitions.log 记录了 session 1/2/3,以及直播主机从 al.flv.huya.com 切换为 tx.flv.huya.com——这证明切换确实落到真实取流地址,而不是"只打开菜单"。

播放器"获取直链":4M 档位与六线路对话框的取消语义

录制期间,通过播放器菜单 获取直链 进入真实清晰度对话框:

  • 选择独立的 4M 档位后,展示出 六条 FLV/HLS 线路;
  • 点击取消,返回原播放器后仍是 8M/线路 2,录制继续;
  • 没有点击复制,因此不宣称剪贴板写入已验证。

这一子场景验证了"取消选择不污染当前播放/录制状态"的边界行为。

录制中心档位为何与播放器不一致:defaultQuality 独立解析

一个值得注意的观测点:录制中心显示 20M/线路 1,与播放器当前档位(8M/线路 2)不同。文档明确指出,这不是取直链动作修改播放器或录制设置的证据。

从源码结构看,录制任务解析取流地址时使用的是录制设置里的独立画质偏好,而非播放器当前档位。关键链路如下:

  • 录制设置中画质默认值由 recorder_config.dart 提供:defaultQuality 读取 Hive 键 default_quality(见 recorder_keys.dart),缺省时回落到 player_consts.dart 中 PlayerConsts.resolutions 的第一档;
  • normalizeDefaultQuality 会把非法值收敛到合法档位集合,保证写入与读取始终落在 ['原画', '蓝光8M', '蓝光4M', '超清', '流畅'] 之内;
  • recorder_controller.dart 在启动录制解析流地址时,以 preferredQuality: settings.defaultQuality.value 调用 StreamResolverService.resolveStream,并在解析成功后回写任务的 selectedQuality / selectedQualityId / selectedLineIndex / selectedLine;
  • 录制续签预取(_prefetchRecorderLease)同样使用 settings.defaultQuality.value 作为首选档位,见 recorder_controller.dart。

因此录制中心展示的 20M/线路 1 来源于录制设置偏好与真实解析结果,与播放器界面上用户手动切到的 8M/线路 2 是两套独立状态,互不覆盖。品质选择的具体排序逻辑(精确匹配优先、否则按比例就近、再移到最前)位于 stream_resolver_service.dart。

手动停止与状态流转

手动停止后,录制中心经历 处理中 → 已停止;随后:

  • 返回播放器,视频与弹幕重新出现;
  • 退出直播间,回到热门列表;
  • 立即录制留下"已监控"任务的既有产品语义仍保留,未删除隔离数据。

最终文件与大小修复闭环

录制文件保留于独立候选的 AppData/acceptance_fadd5bdb/RECORDS/huya/杨齐家丶/2026-09-07/11-10-11/20260907_111011_171.mp4,核心指标如下:

指标 本轮实测
最终字节数 33,832,167
SHA-256 DB9209733312E40A8549F288AACFA74EE8EB43EFC09BA707E9755418C464643C
容器时长 207.609667 秒
视频 H.264,1920×1080,60 fps,12,455 帧,207.582667 秒
音频 AAC,8,939 帧,207.563107 秒
卡片停止前/最终 处理中 34.82 MB → 已停止 32.26 MB,最终时长 00:03:27
对账 33,832,167 / 1024² = 32.264868…,保留两位小数 32.26,与卡片一致
完整解码 FFmpeg 退出 0,错误日志 0 B;非仅探测文件头
DTS 逐包 视频/音频均 0 个非正间隔、0 个 >2 秒间隔,最大间隔分别 0.018 / 0.023243 秒

结论:W3-05 中"最终 MP4 替换临时 TS 字节"的新包原生复验子项已完成。

该结论带有限定:本样本没有断流或两次签名续接,不扩大为全部录制验收。开始/停止点击的记录差约 201.950 秒,而媒体约 207.610 秒,差约 5.660 秒;源端预缓冲与起止记录开销的具体贡献尚未验证。逐包无大跳变并不证明媒体时长与墙钟完全相等。

源码级佐证:TS 分片录制与 MP4 原子回写的底层原理

最终 MP4 不是录制过程中直接写出的,而是录制期间以 MPEG-TS 分片落盘、停止后在本地合并为 MP4 的结果,这与文件指标(视频 1080p60 + AAC、卡片大小从 34.82 MB 降到 32.26 MB)完全吻合。两条核心源码链路可以印证:

录制侧(ffmpeg_command_builder.dart):

  • -c copy 流复制,不解码,录制过程轻量;
  • -f segment -segment_format mpegts 按 segment_time 切片,默认 300 秒、取值 clamp(10, 86400);
  • -segment_format_options flush_packets=1:avoid_negative_ts=disabled:max_delay=0:output_ts_offset=1.4,保留 1.4 秒 MPEG-TS 前滚以保护 concat 起始 DTS;
  • 网络输入附加 -reconnect 1 -reconnect_streamed 1 -reconnect_on_network_error 1 -reconnect_on_http_error 5xx,只对服务端错误重连,认证/签名失效留给平台侧重新取 URL;
  • -dts_delta_threshold 2 -dts_error_threshold 2 配合 +genpts 修正 CDN 时间戳跳变。

合并侧(video_processor_service.dart):

  • 读取分片日志(journal),校验空分片/缺失分片后生成 concat manifest(.ffconcat);
  • FFmpeg 以 -f concat -c copy -movflags +faststart -f mp4 合并,并显式加 -xerror 在 demux/mux 错误时失败;
  • 合并先写 *.mp4.partial,成功后原子提交为最终 MP4(_uniqueOutputFile),失败/取消时保留源分片不删除,保证原始素材可重试。

这正是文档中"处理中 34.82 MB → 已停止 32.26 MB"大小变化的技术原因:处理中卡片展示的是分片累计,停止后合并去除了分片冗余并以最终 MP4 为准。

资源与退出:两段场景的 CPU / 内存 / 句柄实测

使用既有只读采样器,采样对象均为 PID 77992;GPU 未采样,不填 0 代替未知。

场景 响应 CPU均值/P95(24逻辑核归一) Working Set 首→末 Private Bytes 首→末 句柄/线程 首→末
录制、选择器及录制中心混合交互,180.614秒 19/19 2.3805% / 3.307% 895.2109→935.4688 MiB 1199.5703→1217.1875 MiB,峰值1450.2148 2120→2106 / 337→332
退出直播间回热门列表,60.612秒 13/13 2.3266% / 2.605% 819.5430→725.5977 MiB 1086.5352→955.8750 MiB 1709→1324 / 245→156

第二段资源明确回落,日志有 VideoOutput/Texture 释放;但列表 CPU 仍约 2.3%,没有归因为 Debug 开销或判定性能通过。文档特别强调两点限定:第一段不是全程前台视频播放的纯场景,第二段开始阶段并行做了本地媒体解码;其 CPU 指标属于应用进程,仍应保留测试负载背景。后续需分离静止列表、滚动、视频和弹幕负载,并用 Release 同链定位。

退出路径为窗口关闭 → 退出确认,随后查询 PID 77992 已消失;测试 FFmpeg 解码进程和两个采样会话均退出 0,未终止其他应用或后台工作。

证据归档与剩余工作

本地目录 local-artifacts/windows-playback-fadd5bdb-20260907/ 包含:process、UI accessibility 摘录、原始 stdout/stderr、播放器转移摘录、两份采样 CSV/JSON、ffprobe、文件哈希、逐包和完整解码结果、开始/停止点击时间。视觉判断使用任务中的原生截图;accessibility 可能滞后于页面转场,不能把其空树解释为页面缺失。带临时签名的线路原始数据只留本地,不提交到文档。

本轮更新 W2-04 / W3-05 候选增量但保持 RUN(状态账本见 ACCEPTANCE_MATRIX_3_1_0.md):

  • 仍需虎牙跨两次续接、其余平台短录/代表长录、复制/DLNA、窗口/音频/PiP 组合和 Release 性能对照(长录基线可参考 Windows 长录审计);
  • 历史总表仍 20 PASS / 32 RUN / 10 NR;42 大项未闭环,不以本轮单平台成功替代整个目标。

一句话总结:本轮在真实 Windows 候选上完整跑通了"虎牙播放 → 画质/线路切换 → 取直链取消 → 录制收尾 → MP4 对账与解码"的闭环,确认了录制中心档位独立于播放器档位的设计语义,并再次验证"TS 分片 + 停止后原子合并为 MP4"的录制链路;但它是有边界的增量证据,跨断流续接与多平台覆盖仍是后续验收重点。

登录后查看全文
pure_live