57 lines
2.5 KiB
Markdown
57 lines
2.5 KiB
Markdown
# 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` 是否存在,缺了直接报错,不会悄悄打出一个不能用的包。
|