FFprobe使用指南
Posted blackhumour2018
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了FFprobe使用指南相关的知识,希望对你有一定的参考价值。
1. ffprobe 是什么 ?
简单的说,ffprobe 是一个多媒体流分析工具。它从多媒体流中收集信息,并且以人类和机器可读的形式打印出来。
它可以用来检测多媒体流的容器类型,以及每一个多媒体流的格式和类型。它可以作为一个独立的应用来使用,也可以结合文本过滤器执行更复杂的处理。
2. ffprobe 的使用方式
命令行: ffprobe [选项] [‘输入文件’]
3. ffprobe 可使用的选项
3.1 流指示符
流指示符用来精确的指定一个给定的选项是属于哪个(些)流。
一个流指示符通常是一个字符串附加到一个选项名的后面,并且以“:”进行分割。例如:-codec:a:1 ac3 包含流指示符 a:1 ,它将匹配第二个音频流。因此,它将为第二个音频流指定 ac3 codec。
一个流指示符可以匹配多个流,这样,给定的选项会被应用到所有的匹配流上。例如:-b:a 128k 中的流指示符将匹配所有的音频流。
一个空流指示符将匹配所有的流。例如:-codec copy 或 -codec: copy 将拷贝所有的流,而不会对它们重新编码。
可能的流指示符的形式:
01.
‘stream_index’ 匹配具有该索引值的流。例如:-threads:
1
4
将为第二个流设置线程数为
4
。
02.
‘stream_type[:stream_index]’
03.
stream_type 是下面的其中之一:’v’ 视频, ’a’ 音频, ’s’ 字幕, ’d’ 数据,
04.
’t’ 附件。如果给定 stream_index ,它将匹配该类型下的索引号为
05.
stream_index 的流,否则,它将匹配该类型的所有流。
06.
‘p:program_id[:stream_index]’
07.
如果给定 stream_index ,它将匹配 id 为 program_id 的 program 下的索
08.
引号为 stream_index 的流,否则,它将匹配该 program 下的所有流。
09.
‘#stream_id or i:stream_id’ 使用流 id 进行匹配(例如:MPEG-TS 容器中的 PID )
3.2 通用选项
ff* 工具的通用选项是共享的。(FFplay)
01.
‘-L’ 显示 license
02.
‘-h, -?, -help, --help [arg]’ 打印帮助信息;可以指定一个参数 arg ,如果不指定,只打印基本选项
03.
可选的 arg 选项:
04.
‘
long
’ 除基本选项外,还将打印高级选项
05.
‘full’ 打印一个完整的选项列表,包含 encoders, decoders, demuxers, muxers, filters 等的
06.
共享以及私有选项
07.
‘decoder=decoder_name’ 打印名称为 “decoder_name” 的解码器的详细信息
08.
‘encoder=encoder_name’ 打印名称为 “encoder_name” 的编码器的详细信息
09.
‘demuxer=demuxer_name’ 打印名称为 “demuxer_name” 的 demuxer 的详细信息
10.
‘muxer=muxer_name’ 打印名称为 “muxer_name” 的 muxer 的详细信息
11.
‘filter=filter_name’ 打印名称为 “filter_name” 的过滤器的详细信息
12.
13.
‘-version’ 显示版本信息
14.
‘-formats’ 显示有效的格式
15.
‘-codecs’ 显示 libavcodec 已知的所有编解码器
16.
‘-decoders’ 显示有效的解码器
17.
‘-encoders’ 显示有效的编码器
18.
‘-bsfs’ 显示有效的比特流过滤器
19.
‘-protocols’ 显示有效的协议
20.
‘-filters’ 显示 libavfilter 有效的过滤器
21.
‘-pix_fmts’ 显示有效的像素格式
22.
‘-sample_fmts’ 显示有效的采样格式
23.
‘-layouts’ 显示通道名称以及标准通道布局
24.
‘-colors’ 显示认可的颜色名称
25.
‘-hide_banner’ 禁止打印欢迎语;也就是禁止默认会显示的版权信息、编译选项以及库版本信息等
3.3 一些主要选项
01.
‘-f format’ 强制使用的格式
02.
‘-unit’ 显示值的单位
03.
‘-prefix’ 显示的值使用标准国际单位制词头
04.
‘-byte_binary_prefix’ 对字节值强制使用二进制前缀
05.
‘-sexagesimal’ 时间值使用六十进位的格式 HH:MM:SS.MICROSECONDS
06.
‘-pretty’ 美化显示值的格式。它相当于
"-unit -prefix -byte_binary_prefix -sexagesimal"
07.
‘-of, -print_format writer_name[=writer_options]’
08.
设置输出打印格式。writer_name 指定打印程序 (writer) 的名称,writer_options
09.
指定传递给 writer 的选项。例如:将输出打印为 JSON 格式:-print_format json
10.
‘-select_streams stream_specifier’
11.
只选择 stream_specifier 指定的流。该选项只影响那些与流相关的选项
12.
(例如:show_streams, show_packets, 等)。
13.
举例:只显示音频流,使用命令:
14.
ffprobe -show_streams -select_streams a INPUT
15.
‘-show_data’ 显示有效载荷数据,以十六进制和ASCII转储。与 ‘-show_packets’ 结合使用,它将
16.
dump 包数据;与 ‘-show_streams’ 结合使用,它将 dump codec 附加数据。
17.
‘-show_error’ 显示探测输入文件时的错误信息
18.
‘-show_format’ 显示输入多媒体流的容器格式信息
19.
‘-show_packets’ 显示输入多媒体流中每一个包的信息
20.
‘-show_frames’ 显示输入多媒体流中的每一帧以及字幕的信息
21.
‘-show_streams’ 显示输入多媒体流中每一个流的信息
22.
‘-show_programs’ 显示输入多媒体流中程序以及它们的流的信息
23.
‘-show_chapters’ 显示格式中存储的章节信息
24.
‘-count_frames’ 计算每一个流中的帧数,在相应的段中进行显示
25.
‘-count_packets’ 计算每一个流中的包数,在相应的段中进行显示
26.
‘-show_program_version’ 显示程序版本及配置相关信息
27.
‘-show_library_versions’ 显示库版本相关信息
28.
‘-show_versions’ 显示程序和库版本相关信息。相当于同时设置‘-show_program_version’ 和
29.
‘-show_library_versions’
30.
‘-i input_file’ 指定输入文件
4. 打印程序(Writers)
一个 writer 定义了 ffprobe 所使用的输出格式。
它可以接受一个或多个参数,这些参数以 key=value 的形式指定,以“:”分隔。所有的 writers 都支持以下选项:
1.
‘string_validation, sv’ 设置字符串验证模式
2.
它可以接受以下值:(默认为 replace)
3.
‘fail’ 当发现无效字符串(UTF-
8
)序列或代码点时,立即失败。这个对于验证输入 metadata 非常有用。
4.
‘ignore’ 任何验证错误都将被忽略。
5.
‘replace’ writer 将使用 ‘string_validation_replacement’ 所指定的字符串替代无效的UTF-
8
序列或者代码点。
6.
7.
‘string_validation_replacement, svr’ 设置替代字符串,当 ‘string_validation’ 设置为 ‘replace’ 时使用。
以下为目前可以使用的 writers :
01.
4.1
default
02.
默认格式。按照以下形式打印每个 section :
03.
[SECTION]
04.
key1=val1
05.
...
06.
keyN=valN
07.
[/SECTION]
08.
09.
4.2
compact, csv
10.
紧凑与CSV格式。每个 section 打印在一个单独的行。如果不指定其他选项,其输入格式如下:
11.
section|key1=val1| ... |keyN=valN
12.
13.
4.3
Flat
14.
一种自由格式输出,每一行包含一个明确的 key=value 对。
15.
16.
4.4
ini
17.
INI 格式输出。
18.
19.
4.5
json
20.
JSON 格式输出。每一个 section 使用 JSON 符号来打印。
21.
22.
4.6
xml
23.
XML 格式输出。
24.
25.
各 writer 可接受的选项,请查阅 ffprobe 文档
5. ffprobe 使用示例
01.
1
) 最简单的使用方式
02.
ffprobe test.mp4
03.
04.
2
) 不显示欢迎信息
05.
ffprobe -hide_banner test.mp4
06.
07.
3
) 以 JSON 格式显示每个流的信息
08.
ffprobe -print_format json -show_streams test.mp4
09.
10.
4
) 显示容器格式相关信息
11.
ffprobe -show_format test.mp4
更多 ffprobe 选项,可以使用 ffprobe -h 获取
以上是关于FFprobe使用指南的主要内容,如果未能解决你的问题,请参考以下文章
如何使用 avprobe / ffprobe 检测音频采样率?