编码与格式 / 系统课时
检查硬件加速能力
检查硬件加速能力
本课解决“命令写对了却无法启用硬件加速”的问题。你将按构建信息、设备类型、解码器、编码器和实际运行五个层次检查环境,区分“已编译支持”和“当前机器可用”。
学习目标
- 查询 FFmpeg 构建版本与可识别的硬件设备类型
- 查找当前构建包含的硬件解码器和硬件编码器
- 通过最小测试确认驱动、设备权限与运行时是否正常
先确认 FFmpeg 构建信息
同一版本号的 FFmpeg 可能使用不同编译参数,因此不能只根据版本判断能力。先查看版本、编译器和配置选项,确认当前终端调用的是预期的可执行文件。
ffmpeg -hide_banner -version预期输出
ffmpeg version <VERSION>
built with <COMPILER>
configuration: <CONFIGURATION_OPTIONS>
libavutil <VERSION>
libavcodec <VERSION>
libavformat <VERSION><CONFIGURATION_OPTIONS> 中是否出现某个硬件库,只能说明该构建可能包含相应支持。最终能否使用,还取决于操作系统驱动、硬件型号、设备权限和输入编码格式。
查看硬件设备类型
使用 -hwaccels 查看当前 FFmpeg 构建提供的硬件加速方法,再用 -init_hw_device list 查看可初始化的设备类型。
ffmpeg -hide_banner -hwaccels
ffmpeg -hide_banner -init_hw_device list预期输出
Hardware acceleration methods:
<METHOD_1>
<METHOD_2>
Supported hardware device types:
<DEVICE_TYPE_1>
<DEVICE_TYPE_2>常见名称包括 cuda、qsv、vaapi、videotoolbox、d3d11va 和 vulkan,但实际列表以本机输出为准。列表中出现名称不等于设备一定可初始化,它首先反映当前构建具备对应接口。
查找硬件解码器和编码器
解码器和编码器需要分别查询。硬件编码器通常带有后端后缀,例如 h264_nvenc、h264_qsv、h264_vaapi 或 h264_videotoolbox;硬件解码可能使用专用解码器,也可能通过通用解码器配合 -hwaccel 工作。
ffmpeg -hide_banner -decoders
ffmpeg -hide_banner -encoders预期输出
Decoders:
V..... <VIDEO_DECODER> <DESCRIPTION>
...
Encoders:
V..... <VIDEO_ENCODER> <DESCRIPTION>
...输出较长时,可在终端中搜索 cuvid、qsv、vaapi、nvenc、videotoolbox、amf 或 v4l2m2m。不要因为解码器列表里没有 vaapi 后缀就直接判定不可用,因为 VAAPI 等后端常通过硬件设备上下文配合通用解码器完成解码。
做一次真实运行验证
能力列表只能证明 FFmpeg 认识相关接口。最可靠的方法是执行一次最小编码任务。下面以 NVIDIA NVENC 为例,生成三秒测试画面并交给 h264_nvenc 编码,不依赖外部媒体文件。
ffmpeg -hide_banner -f lavfi -i testsrc2=size=1280x720:rate=30 -t 3 -c:v h264_nvenc -f null -预期输出
Stream mapping:
Stream #0:0 -> #0:0 (rawvideo (native) -> h264 (h264_nvenc))
frame=<N> ... time=<TIME> ... speed=<SPEED>x成功结束说明 FFmpeg 已找到 NVENC 编码器,并且驱动与运行时能够完成编码。若本机使用其他后端,应把编码器替换为设备实际提供的名称,并按该后端要求补充设备路径或像素格式。
按错误信息定位问题
出现 Unknown encoder,通常表示当前 FFmpeg 构建没有包含该编码器。出现设备初始化失败、驱动版本不匹配或动态库缺失,说明编码器存在,但运行时环境不可用。
Linux 上的 VAAPI 还需要检查 /dev/dri/renderD* 是否存在以及当前用户是否有访问权限。容器环境则需要把设备节点和相关驱动库一并映射进去。修复后应重新执行最小测试,而不是只重复查看 -encoders 列表。