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

59 lines
2.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# native\ffmpeg —— 内置 ffmpeg(随安装包一起发)
> **当前内置**:`ffmpeg version 9.0.2-essentials_build`(gyan.dev),100.5 MB,静态单文件,
> 含 `libx264`(合并要重新编码),也带 `h264_qsv` / `h264_nvenc` / `h264_amf` 硬件编码器
> (合并时优先用核显/独显编码,见 [../../README.md](../../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
```
## 校验
```powershell
.\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` 是否存在,缺了直接报错,不会悄悄打出一个不能用的包。