ffmpeg插件lavfi使用

简介

lavfi 是 FFmpeg 滤镜框架配套的虚拟输入源，用 testsrc 这类内置源直接生成测试画面，不需要准备任何外部视频文件。它解决的是「想验证一条处理链路，手头却没有合适素材」的问题：插件开发、滤镜回归、自动化测试都能随取随用。核心优势在于结果可复核——生成的输出可以用 framemd5 摘要比对两次运行是否逐帧一致，也能与参考输出对比，确认滤镜确实产生了预期变化，排查问题时不必反复更换素材。

核心功能

• 用内置 testsrc 源现场生成测试视频，省去寻找或下载素材文件的步骤。
• 输入沿用 -i 标记的统一约定，与普通文件、管道、网络流、设备源属于同一套命令结构，切换输入类型时不必重写参数框架。
• 输出可导出 framemd5，用于比对两次运行结果是否逐帧一致，作为回归判定依据。
• 输出文件大小可作为第一道快速指标，与 framemd5 配合使用，先看量级再看摘要。
• 可与插件处理流程直接串联：先由 lavfi 生成源，再运行插件处理，最后验证输出文件与摘要。
• 支持与预先保存的参考输出做对比，用来确认滤镜确实接入了链路并产生了变化，而不是被跳过。

使用场景

• 插件架构开发中的链路验证：先用 lavfi testsrc 生成测试视频，再运行插件处理，最后核对输出。
• 自动化与持续集成回归：输入由命令现场生成，不依赖仓库里的素材文件，脚本可重复执行。
• 编码或滤镜参数调整前后的对照实验：同一套源跑两次，比对 framemd5 是否一致。
• 研究图像数据转视频类工作的链路预演，先确认转码与封装步骤能跑通，再换真实数据。
• 排查「输出为空」「画面没变化」一类问题：用参考输出对比，判断是链路没接上还是滤镜未生效。

安装与获取步骤

1. Linux 环境执行 sudo apt-get install ffmpeg，由系统拉取软件包及其依赖项。
2. 安装完成后执行 ffmpeg -version，确认版本信息正常输出、可执行文件可用。
3. Windows 环境从 https://www.gyan.dev/ffmpeg/builds/ 获取构建包，解压到任意目录，再把 bin 目录加入系统 PATH。
4. 需要自行编译时可参考 MinGW+msys 方案，见 https://developer.aliyun.com/article/243283，注意不同版本环境会导致参考文章的步骤对不上。
5. 改完环境变量后重开终端，再次执行 ffmpeg -version，确认 PATH 已生效。
6. 跑一条 testsrc 命令生成短片，确认 lavfi 源可用；滤镜与参数清单见 https://github.com/FFmpeg/FFmpeg，具体取值以官方页面为准。

常用命令与验证要点

一条最小可用的生成命令形如：ffmpeg -f lavfi -i testsrc=duration=2:size=320x240:rate=25 out.mp4。其中 -f lavfi 指定输入协议，testsrc 后的 duration、size、rate 分别控制时长、分辨率与帧率，参数取值以官方页面为准。生成后可先用 ffprobe 或播放器确认画面与时长，再把同一条命令跑两次，比较两次输出的 framemd5 是否相同。

接入滤镜或插件时的推荐顺序是：先保存一份不加处理的参考输出，再运行带处理的命令，最后同时比对文件大小与 framemd5。若两者与参考输出完全一致，说明滤镜没有真正接入链路；若 framemd5 不同但文件大小相同，属于预期的像素级变化。

注意事项

• framemd5 比对要求两次命令的分辨率、帧率、像素格式完全一致，任何一项不同都会导致摘要必然不相等。
• 只比较文件大小不足以证明结果一致，大小相同也可能内容不同，必须配合 framemd5 判定。
• 参考输出需要自己提前生成并保存，否则没有基线可比，无法判断滤镜是否真的生效。
• 命令行参数与可用滤镜清单会随构建差异变化，遇到参数不识别时以官方页面为准。
• Windows 下若提示找不到 ffmpeg，通常是 PATH 未生效，改完环境变量需要重开终端再试。
• 把 lavfi 输出接入后续处理时，先用短时长、小分辨率的源跑通链路，再放大参数，便于快速定位问题。