编码与格式 / 系统课时

用 ffprobe 核对编码流参数

用 ffprobe 核对编码流参数

完成视频编码后,不能只凭文件扩展名、体积或播放器能否打开来判断结果是否正确。本课使用 ffprobe 读取视频流的编码格式、Profile、像素格式、分辨率、帧率和码率,并通过可重复执行的检查命令,确认输出文件是否符合实验要求。

学习目标

  • 使用 ffprobe 精确查询视频流参数,理解各字段的含义。
  • 区分 MP4 等封装容器与 H.264 等视频编码格式。
  • 根据实验目标核对编码结果,识别帧率、像素格式和码率异常。

准备可检查的视频文件

ffprobe 是 FFmpeg 项目提供的媒体探测工具。首先确认本机已经安装 FFmpeg,并且 ffprobe 与 ffmpeg 可以在终端中执行。

bash
ffprobe -version

预期结果:终端显示以 ffprobe version 开头的版本信息,后面通常包含编译配置和库版本。具体版本号因安装环境而异。

为了让后续结果可复现,使用 FFmpeg 内置测试画面生成一个 5 秒、1280×720、30 fps 的 H.264 视频。以下命令要求 FFmpeg 构建包含 libx264 编码器。

bash
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 限制输出字段。

bash
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

预期输出(典型结构,码率仅为示意):

json
{
  "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 编码。

使用下面的命令同时查询容器和视频流:

bash
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,剩余差异可能来自封装开销、统计口径和舍入。不要用总体码率直接判断视频编码器是否达到目标码率。

如果需要理解容器与内部流的层级关系,可以对照下面的结构示意。

MP4 封装容器与内部媒体流的关系

检查实验设置是否真正生效

假设实验验收条件为:H.264 编码、1280×720 分辨率、30 fps、yuv420p 像素格式,以及 5 秒左右的时长。可以一次性提取字段并保存为 JSON,方便后续脚本或人工核对。

bash
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 和文件字节数应读取真实值,不应填入固定的验收常量。

逐项核对时,可以采用以下标准:

  1. 编码格式必须与指定编码器一致;codec_name 错误属于明确的编码结果不匹配。
  2. 宽度和高度分别精确匹配 1280 与 720;不要把播放器缩放后的窗口尺寸当作编码分辨率。
  3. pix_fmt 必须为 yuv420p;若输出 yuv444p,部分硬件解码设备可能不支持。
  4. avg_frame_rate 应为 30/1;如果发现 30000/1001,实际约为 29.97 fps,与精确 30 fps 的要求不同。
  5. 时长在实验允许范围内;本测试文件应接近 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 文件损坏、不完整或不是受支持的媒体文件 核对文件来源、大小和封装格式

如果怀疑可变帧率或时间戳异常,可以进一步读取逐帧信息:

bash
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 或文件能够播放就认定编码正确。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 ffprobe 核对编码流参数

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通