编码与格式 / 系统课时

控制 ffprobe 输出

控制 ffprobe 输出

ffprobe 默认结果字段很多,直接交给程序处理既冗余又不稳定。本课将组合 -select_streams、-show_entries 和 -of,只保留所需字段并输出结构化 JSON。

学习目标

  • 使用 -show_entries 精确筛选区段和字段
  • 选择 JSON、默认文本等合适的输出格式
  • 为脚本调用构造稳定、低噪声的探测命令

输出控制的三层逻辑

控制结果时可以按三步思考:先用 -select_streams 决定检查哪条流,再用 -show_entries 决定保留哪些字段,最后用 -of 指定结果的序列化格式。

-show_entries 的基本形式是 section=field1,field2。多个区段之间使用冒号分隔,例如同时读取流字段和流标签时,可以写成 stream=...:stream_tags=language。

筛选字段并输出 JSON

下面只读取第一条视频流的编号、编码格式、分辨率、平均帧率和语言标签:

bash
ffprobe -v error -select_streams v:0 -show_entries stream=index,codec_name,width,height,avg_frame_rate:stream_tags=language -of json "input.mp4"

假设文件的第一条视频流是 1920×1080、30 fps 的 H.264 视频,核心输出如下:

json
{
  "programs": [],
  "streams": [
    {
      "index": 0,
      "codec_name": "h264",
      "width": 1920,
      "height": 1080,
      "avg_frame_rate": "30/1",
      "tags": {
        "language": "und"
      }
    }
  ]
}

不同 FFmpeg 版本可能额外输出空的 stream_groups 数组;程序应读取 streams 字段,而不是依赖顶层字段的固定排列。文件没有语言标签时,tags 或 language 也可能缺失。

选择合适的输出器

-of 是 -print_format 的简写,用于选择输出器。常见形式如下:

输出器 适用场景 特点
json 应用程序、接口和批处理 保留字段名与层级,最容易安全解析
default Shell 获取单个值 可通过参数隐藏区段名和键名
compact 日志或逐行处理 一条记录占一行,体积较小
csv 导入表格或简单管道 结构扁平,需处理分隔符和转义

程序读取多个字段时优先使用 JSON。只有明确只取一个值时,才适合关闭字段名,避免结果含义依赖位置。

获取单个值

下面仅输出容器时长,并隐藏区段包装和字段名:

bash
ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 "input.mp4"

假设文件时长为 12.345 秒,预期输出为:

text
12.345000

noprint_wrappers=1 去掉 [FORMAT] 等包装,nokey=1 去掉 duration=。实际数值由输入文件决定,脚本仍应校验空值和非数字结果。

编写可供程序解析的命令

稳定的探测命令通常遵循以下原则:

  • 保留 -v error,避免普通日志混入标准输出。
  • 明确写出所需区段和字段,不依赖 -show_streams 的完整字段集合。
  • 将 avg_frame_rate 等分数字段按字符串读取,再由程序计算。
  • 对可选字段做缺失判断,例如语言标签、码率和时长并非所有流都具备。
  • 不依赖 JSON 对象字段顺序,按字段名访问数据。

当命令运行失败时,ffprobe 通常通过非零退出码和标准错误说明原因。程序不仅要解析标准输出,还应检查退出码,避免把空结果误判为“没有媒体流”。

常见错误

stream_tags=language 与 stream=language 含义不同,语言属于标签区段,写错后通常得不到字段。使用 nokey=1 输出多个值时也容易失去字段对应关系,因此不适合长期维护的程序接口。

另一个常见问题是把 avg_frame_rate 当作 JSON 数字。它实际常以 "30000/1001" 形式出现,应先拆分分子和分母,并处理分母为零的异常情况。

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

目录与阅读设置

阅读设置

17

记录一个想法

控制 ffprobe 输出

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

登录哪都通