编码与格式 / 系统课时
用 ffprobe 核对编码流参数
用 ffprobe 核对编码流参数
完成视频编码后,不能只凭文件扩展名、体积或播放器能否打开来判断结果是否正确。本课使用 ffprobe 读取视频流的编码格式、Profile、像素格式、分辨率、帧率和码率,并通过可重复执行的检查命令,确认输出文件是否符合实验要求。
学习目标
- 使用 ffprobe 精确查询视频流参数,理解各字段的含义。
- 区分 MP4 等封装容器与 H.264 等视频编码格式。
- 根据实验目标核对编码结果,识别帧率、像素格式和码率异常。
准备可检查的视频文件
ffprobe 是 FFmpeg 项目提供的媒体探测工具。首先确认本机已经安装 FFmpeg,并且 ffprobe 与 ffmpeg 可以在终端中执行。
ffprobe -version预期结果:终端显示以 ffprobe version 开头的版本信息,后面通常包含编译配置和库版本。具体版本号因安装环境而异。
为了让后续结果可复现,使用 FFmpeg 内置测试画面生成一个 5 秒、1280×720、30 fps 的 H.264 视频。以下命令要求 FFmpeg 构建包含 libx264 编码器。
ffmpeg -f lavfi -i testsrc2=size=1280x720:rate=30 -t 5 -c:v libx264 -preset medium -crf 23 -pix_fmt yuv420p -an -y sample.mp4预期结果:命令正常结束,在当前目录生成 sample.mp4。终端末尾显示编码统计信息;实际文件大小和平均码率取决于编码器版本及编码内容,不应预设固定值。
这里的 -crf 23 是恒定质量模式的质量控制参数,并非固定 23 Mb/s 或其他目标码率。-pix_fmt yuv420p 则明确指定输出像素格式。
如果提示 Unknown encoder 'libx264',说明当前 FFmpeg 构建没有提供该编码器,需要安装包含 libx264 支持的版本。不要在未确认编码器能力时直接更换成其他编码器,否则实验结果会失去可比性。
读取关键视频流字段
最直接的检查方式是使用 -select_streams v:0 选择第一个视频流,再用 -show_entries 限制输出字段。
ffprobe -v error -select_streams v:0 -show_entries stream=index,codec_name,profile,pix_fmt,width,height,r_frame_rate,avg_frame_rate,bit_rate -of json sample.mp4预期输出(典型结构,码率仅为示意):
{
"programs": [],
"streams": [
{
"index": 0,
"codec_name": "h264",
"profile": "High",
"width": 1280,
"height": 720,
"pix_fmt": "yuv420p",
"r_frame_rate": "30/1",
"avg_frame_rate": "30/1",
"bit_rate": "1500000"
}
]
}不同 FFmpeg 版本可能省略空的 programs 数组,字段顺序也不应作为验证依据。这里的 bit_rate 是示例值,不代表上述 CRF 命令必然生成 1500000 bit/s。
关键字段应这样理解:
| 字段 | 含义 | 本实验的检查重点 |
|---|---|---|
codec_name |
编码格式名称 | 应为 h264 |
profile |
编码工具集级别 | 通常为 High,以实际探测结果为准 |
pix_fmt |
解码后像素格式 | 应为 yuv420p |
width、height |
视频流显示的编码分辨率 | 应为 1280、720 |
r_frame_rate |
流声明的基础或推定帧率 | 预期 30/1 |
avg_frame_rate |
根据时间戳或帧数信息得到的平均帧率 | 预期 30/1 |
bit_rate |
视频流报告的平均码率,单位 bit/s | CRF 模式下随内容变化 |
r_frame_rate 并不保证视频每一帧的时间间隔都相同。对于可变帧率素材,不能只比较这两个帧率字段就断言它是恒定帧率;需要进一步检查帧时间戳。
区分封装容器和编码格式
MP4 是封装容器,H.264 是视频编码格式。一个 MP4 文件可以包含 H.264、H.265 或 AV1 视频流,也可以同时包含音频和字幕。文件名以 .mp4 结尾,并不能证明视频使用 H.264 编码。
使用下面的命令同时查询容器和视频流:
ffprobe -v error -show_entries format=format_name,duration,bit_rate:stream=index,codec_type,codec_name -of json sample.mp4预期结果:format.format_name 通常包含 mov,mp4,m4a,3gp,3g2,mj2,视频流中 codec_type 为 video、codec_name 为 h264。由于生成命令包含 -an,这个示例不会生成音频流。
这里还要区分两种码率:
stream.bit_rate:特定视频流的码率,不包含其他流和封装开销。format.bit_rate:整个文件按文件大小和时长计算的总体平均码率,包含封装开销以及所有媒体流。
例如,一个文件的总体平均码率为 2.2 Mb/s,其中视频流为 2.0 Mb/s、音频流为 0.16 Mb/s,剩余差异可能来自封装开销、统计口径和舍入。不要用总体码率直接判断视频编码器是否达到目标码率。
如果需要理解容器与内部流的层级关系,可以对照下面的结构示意。

检查实验设置是否真正生效
假设实验验收条件为:H.264 编码、1280×720 分辨率、30 fps、yuv420p 像素格式,以及 5 秒左右的时长。可以一次性提取字段并保存为 JSON,方便后续脚本或人工核对。
ffprobe -v error -select_streams v:0 -show_entries stream=codec_name,profile,pix_fmt,width,height,avg_frame_rate,bit_rate:format=duration,size -of json sample.mp4预期结果:视频流字段分别符合 h264、yuv420p、1280、720、30/1;容器时长通常为 5.000000 秒。profile、bit_rate 和文件字节数应读取真实值,不应填入固定的验收常量。
逐项核对时,可以采用以下标准:
- 编码格式必须与指定编码器一致;
codec_name错误属于明确的编码结果不匹配。 - 宽度和高度分别精确匹配 1280 与 720;不要把播放器缩放后的窗口尺寸当作编码分辨率。
pix_fmt必须为yuv420p;若输出yuv444p,部分硬件解码设备可能不支持。avg_frame_rate应为30/1;如果发现30000/1001,实际约为 29.97 fps,与精确 30 fps 的要求不同。- 时长在实验允许范围内;本测试文件应接近 5 秒。如果实际时长出现较大偏差,应检查输入时基、帧时间戳与裁剪参数。
常见异常与定位办法
当 ffprobe 输出不符合预期时,先判断是探测命令选择错误,还是编码文件本身确实不符合要求。
| 现象 | 常见原因 | 处理办法 |
|---|---|---|
没有 streams 数据 |
文件中没有可识别的视频流,或视频流选择条件不匹配 | 去掉 -select_streams 查看全部流 |
codec_name 为 hevc |
使用了 H.265 编码器而非 H.264 | 检查 FFmpeg 的 -c:v 参数 |
pix_fmt 为 yuv444p |
输出像素格式未约束或源格式影响编码设置 | 明确指定 -pix_fmt yuv420p 并重新编码 |
avg_frame_rate 不等于目标值 |
输入帧率、时间戳或输出帧率设置不同 | 检查滤镜、-r 与输入时间基 |
bit_rate 缺失 |
某些流、封装格式或不完整文件无法提供该统计值 | 同时查看 format.bit_rate,必要时根据文件大小和时长估算 |
提示 Invalid data found when processing input |
文件损坏、不完整或不是受支持的媒体文件 | 核对文件来源、大小和封装格式 |
如果怀疑可变帧率或时间戳异常,可以进一步读取逐帧信息:
ffprobe -v error -select_streams v:0 -show_frames -show_entries frame=best_effort_timestamp_time -of csv=p=0 sample.mp4预期输出:每行一个视频帧时间戳,正常的 30 fps 测试流从接近 0.000000 开始,相邻显示帧的时间差约为 0.033333 秒,实际显示顺序和精度取决于流中的时间戳。5 秒测试素材预期约有 150 帧。
最终的合格判定应基于实际字段与实验要求逐项匹配,而不是仅看到 h264 或文件能够播放就认定编码正确。