2.5 KiB
2.5 KiB
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):
- 环境变量
YUNCANG_FFMPEG(指向 ffmpeg.exe,用于临时换版本排障) - 程序目录下
native\ffmpeg\ffmpeg.exe← 安装包带的就是这个 - 系统 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是否存在,缺了直接报错,不会悄悄打出一个不能用的包。