57 lines
2.5 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`(合并要重新编码)。安装包里就是这一份,客户机不需要自己装 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` 是否存在,缺了直接报错,不会悄悄打出一个不能用的包。