liufumingren 2a81047f81 perf(desktop): 回放合并改用 xstack 一次合成 + 硬件编码(含自动兜底)
合成(ComposeAsync):
- 链式 overlay 在 1080p 画布上要走 N-1 遍整帧混合,改成一条 xstack 一次合成;
  画布比矩形并集大就 pad 补黑,越界摆位就 crop 裁掉(等价于原来叠在黑画布上)
- 实测(本机 i5-12400 + UHD 730):60s x 4 路 24.7s -> 16.1s(libx264)、
  26.5s -> 16.5s(qsv);120s 片段走 ComposeAsync 实路径 36.3s -> 25.2s
- 输出与旧实现逐像素一致(PSNR inf):标准 2x2、混合尺寸、留空、越界裁剪四种布局;
  矩形重叠时 z-order 与 overlay 一致

编码器(新增 FfmpegVideoEncoder):
- 优先 h264_qsv / h264_nvenc / h264_amf,都没有或跑不起来回落 libx264
- 探测 = 拿 0.2 秒黑场真编一帧(看 -encoders 列表不够:装 nvenc 没 N 卡也在列表里),
  结果缓存在进程内;QSV 探测约 1 秒,驱动缺失的候选 0.05 秒,单个候选上限 4 秒
- 硬件编码失败(非 0 退出 / 退出码 0 但没写出成片)自动用 libx264 重试一次
- 质量档位对齐原 crf23:qsv gq26(PSNR 持平,体积 +7%)、nvenc/amf qp26
- 排障:YUNCANG_COMPOSE_ENCODER 可跳过探测强制指定,写错名字按 libx264 处理

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-17 01:20:33 +08:00
..

native\ffmpeg —— 内置 ffmpeg(随安装包一起发)

当前内置:ffmpeg version 9.0.2-essentials_build(gyan.dev),100.5 MB,静态单文件, 含 libx264(合并要重新编码),也带 h264_qsv / h264_nvenc / h264_amf 硬件编码器 (合并时优先用核显/独显编码,见 ../../README.md 的「合并用的编码器」)。 安装包里就是这一份,客户机不需要自己装 ffmpeg。

为什么放在这里

回放校验、多路合并、主码流转 MJPEG 都靠 ffmpeg。以前没打进安装包,客户机必须自己装 ffmpeg —— 非设备服务器(普通查件电脑)就永远「合并失败,已保留各路段」。

现在 YuncangTrace.LocalService.csproj 会把本目录的内容复制到 publish\native\ffmpeg\, installer\Product.wxs 的 <Files Include="..\publish\native\**" /> 再把它装到 %LOCALAPPDATA%\Programs\YuncangTrace\native\ffmpeg\。

运行时查找顺序(HikFfmpegService.ResolveFfmpeg):

  1. 环境变量 YUNCANG_FFMPEG(指向 ffmpeg.exe,用于临时换版本排障)
  2. 程序目录下 native\ffmpeg\ffmpeg.exe ← 安装包带的就是这个
  3. 系统 PATH 里的 ffmpeg.exe

放什么

只需要一个文件:desktop\native\ffmpeg\ffmpeg.exe(静态构建,不带 DLL)。

  • ffmpeg.exe 要 ExcludeFromSingleFile(已在 csproj 里配好),否则会被塞进自解压 exe,体积暴涨且目录不存在。
  • 不要放 ffplay.exe / ffprobe.exe(程序用不到,白占 ~200MB)。

推荐构建(体积从小到大):

来源 ffmpeg.exe 说明
gyan.dev ffmpeg-release-essentials ≈ 100 MB 含 libx264(合并要重新编码),够用
BtbN ffmpeg-master-latest-win64-gpl ≈ 90 MB 同样含 libx264
gyan.dev full_build ≈ 231 MB 库最全,但安装包会涨到 ~190 MB,不建议

下载 zip 后从 bin\ 里取 ffmpeg.exe 拷到本目录即可。

# 例:用 winget 装过 full build 的机器上直接取
Copy-Item "$env:LOCALAPPDATA\Microsoft\WinGet\Packages\Gyan.FFmpeg_*\ffmpeg-*\bin\ffmpeg.exe" `
          "D:\packService\desktop\native\ffmpeg\ffmpeg.exe" -Force

校验

.\desktop\native\ffmpeg\ffmpeg.exe -hide_banner -version
.\desktop\native\ffmpeg\ffmpeg.exe -hide_banner -encoders | Select-String libx264

libx264 必须存在 —— 多路合并走的是 -c:v libx264 -preset veryfast -crf 23。

注意

  • 本目录的 *.exe 不进 git(见根 .gitignore),克隆后按上面的说明放好即可。
  • installer\build.ps1 打包前会检查 publish\native\ffmpeg\ffmpeg.exe 是否存在,缺了直接报错,不会悄悄打出一个不能用的包。