1. 硬解码环境搭建与验证

任务目标

搭建FFmpeg硬解码开发环境，验证当前平台可用的硬件加速后端（NVDEC/QSV/VAAPI），并确认FFmpeg能够识别并调用对应解码器。

环境依赖

• 操作系统：Linux（本文以Ubuntu 22.04为例）或Windows（需安装对应驱动与SDK）
• FFmpeg：需启用硬件加速相关编译选项（--enable-nvenc --enable-vaapi --enable-libmfx 等），或直接使用包含硬件加速的预编译版本
• 显卡驱动：NVIDIA（需支持NVDEC）、Intel（需支持QSV）、AMD（需支持VAAPI）
• 验证工具：ffprobe（FFmpeg自带）

环境检查与验证

首先确认FFmpeg是否已编译硬件加速支持，然后检查各硬件后端是否可用。以下命令用于检测当前环境状态：

# 检查FFmpeg是否包含硬件加速支持
ffmpeg -hwaccels

# 检查可用的硬件解码器（以h264为例）
ffmpeg -decoders | grep -E "h264_(nvdec|qsv|vaapi)"

# 检查VAAPI设备节点是否存在
ls /dev/dri/renderD*

若ffmpeg -hwaccels输出中包含cuda、vaapi、qsv等条目，说明FFmpeg已编译相应支持。若-decoders中能查到对应解码器，说明驱动与FFmpeg对接正常。

硬件解码可用性验证脚本

以下脚本自动检测当前平台可用的硬件解码后端，并输出检测结果。该脚本适用于Linux环境，Windows用户需根据实际SDK路径调整。

#!/bin/bash
# check_hwdecode.sh - 检测FFmpeg硬件解码可用性

echo "=== FFmpeg版本 ==="
ffmpeg -version | head -n 1

echo -e "\n=== 支持的硬件加速方法 ==="
ffmpeg -hwaccels

echo -e "\n=== 硬件解码器检测 ==="
for codec in h264 hevc; do
    echo "--- $codec ---"
    ffmpeg -decoders 2>/dev/null | grep -E "${codec}_(nvdec|qsv|vaapi)" || echo "未找到 ${codec} 硬件解码器"
done

echo -e "\n=== VAAPI设备检查 ==="
if [ -d /dev/dri ]; then
    ls /dev/dri/renderD* 2>/dev/null || echo "未找到renderD节点"
else
    echo "/dev/dri 不存在"
fi

echo -e "\n=== NVIDIA NVML检测 ==="
if command -v nvidia-smi > /dev/null; then
    nvidia-smi --query-gpu=name --format=csv,noheader | head -n 1
else
    echo "未安装NVIDIA驱动或nvidia-smi"
fi

echo -e "\n=== Intel QSV检测 ==="
if command -v vainfo > /dev/null; then
    vainfo 2>&1 | grep -E "VAProfileH264|VAProfileHEVC" | head -n 4
else
    echo "vainfo未安装，可执行: sudo apt install vainfo"
fi

运行方式：

chmod +x check_hwdecode.sh
./check_hwdecode.sh

实际解码验证

生成一个测试视频并用硬件解码器实际解码，确认解码器能正常工作：

# 生成10秒测试视频（使用软件编码）
ffmpeg -f lavfi -i testsrc=duration=10:size=1280x720:rate=30 -c:v libx264 -pix_fmt yuv420p test.mp4

# 使用NVDEC解码（NVIDIA GPU）
ffmpeg -hwaccel cuda -c:v h264_cuvid -i test.mp4 -f null -

# 使用VAAPI解码（AMD/Intel GPU）
ffmpeg -hwaccel vaapi -vaapi_device /dev/dri/renderD128 -i test.mp4 -f null -

# 使用QSV解码（Intel GPU）
ffmpeg -hwaccel qsv -c:v h264_qsv -i test.mp4 -f null -

验证判定标准

• 环境检测通过：ffmpeg -hwaccels输出包含至少一个硬件加速方法；-decoders能查到对应硬件解码器
• 实际解码通过：上述解码命令无报错，输出中不出现Failed to setup、hardware device open failed等错误信息，且命令正常退出（exit code 0）
• 性能确认（可选）：对比软解与硬解的time输出，硬解耗时明显低于软解（如ffmpeg -i test.mp4 -f null -的软解基准）

若某硬件后端检测失败，优先检查：驱动是否安装（nvidia-smi、vainfo）、用户是否在video组（sudo usermod -aG video $USER）、FFmpeg编译选项是否包含对应支持。