编码与格式 / 系统课时
控制 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
下面只读取第一条视频流的编号、编码格式、分辨率、平均帧率和语言标签:
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 视频,核心输出如下:
{
"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。只有明确只取一个值时,才适合关闭字段名,避免结果含义依赖位置。
获取单个值
下面仅输出容器时长,并隐藏区段包装和字段名:
ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 "input.mp4"假设文件时长为 12.345 秒,预期输出为:
12.345000noprint_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" 形式出现,应先拆分分子和分母,并处理分母为零的异常情况。