# 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` 的 `` 再把它装到 `%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` 是否存在,缺了直接报错,不会悄悄打出一个不能用的包。