多媒体流信息提取工具 ffprobe 简介

不念不忘少年蓝@ 2021-09-02 07:28 313阅读 0赞

一、介绍

ffprobe \[options\] \[input\_url\]

ffprobe能从多媒体流中收集信息，并且以人和机器都能理解的方式打印出来。

\[input\_url\]可以是本地文件的路径或者url。

二、options

所有数字选项，如果没有指定，均接受代表数字的字符串作为输入，其后可以是SI单位前缀之一，例如：“K”，“M”或“G”。

如果将“i”附加到SI单位前缀，则完整前缀将被解释为二进制倍数，该二进制倍数是基于1024的幂，而不是1000。在SI单位前缀后面加上“B”，则需将值乘以8。这允许使用“KB”、“MiB”、“G”或“B”作为数字后缀。

不带参数的选项是布尔选项，并将相应的值设置为True。如果想设置为False，可以在参数名前面加上“no”。例如：“-nofoo”表示将名为“foo”的选项设置为False。

1）流说明符

每个流会应用某些选项，例如比特率或编解码器。流说明符用于精确指定给定选项所属的流。

流说明符是附加到选项名称并由冒号分隔的字符串。例如：“-codec:a:1 ac3”包含“a:1”流说明符，该说明符与第二个音频流匹配。因此，它将为第二个音频流选择ac3编解码器。

流说明符可以匹配多个流，此时，该选项将应用于所有这些流。例如：“-b:128k”中的流说明符匹配所有音频流。

空的流说明符匹配所有流。例如，“-codec copy”或“-codec: copy”将复制所有流而无需重新编码。

流说明符的可能形式为：

stream\_index：将流与此索引匹配。例如：“-threads:1 4”会将第二个流的线程计数设置为4。如果将stream\_index用作附加的流说明符（请参见下文），则它将从匹配的流中选择流号stream\_index。流编号基于libavformat检测到的流顺序，除非还指定了程序ID。在这种情况下，它基于程序中流的顺序。

stream\_type\[:additional\_stream\_specifier\]：stream\_type是以下内容之一：“v”或“ V”表示视频，“a”表示音频，“s”表示字幕，“d”表示数据，“t”表示附件。“v”匹配所有视频流，“V”仅匹配未附加图片，视频缩略图或封面艺术的视频流。如果使用了*additional\_stream\_specifier*，则它将匹配具有这种类型的流，并匹配 *additional\_stream\_specifier*。否则，它将匹配指定类型的所有流。

p:program\_id\[:additional\_stream\_specifier\]：匹配*program*中ID为program\_id的流。如果使用了*additional\_stream\_specifier*，则它匹配既是*program*一部分又与*additional\_stream\_specifier*匹配的流。

\#stream\_id or i:stream\_id：按流ID匹配流（例如MPEG-TS容器中的PID）。

m:key\[:value\]：匹配具有指定值的元数据标签的流。如果未提供value，则匹配包含给定标签（任何值均可）的流。

u：将流与可用配置匹配，必须定义编解码器，并且必须提供基本信息，例如视频尺寸或音频采样率。

2）通用选项

这些选项在ff\*工具中一致。

\-L：显示license。

\-h, -?, -help, –help \[arg\]：显示help。可以指定一个可选参数来打印有关特定项目的帮助。如果未指定任何参数，则仅显示基本（非高级）工具选项。以下为可能的参数：

*  long：除基本工具选项外，还打印高级工具选项。
 *  full：打印完整的选项列表，包括编码器，解码器，解复用器，复用器，滤波器等的共享和专用选项。
 *  decoder=decoder\_name：打印名为*decoder\_name*的解码器的详细信息。使用-decoders选项可获取所有解码器的列表。
 *  encoder=encoder\_name：打印名为*encoder\_name*的编码器的详细信息。使用-encoders选项可获取所有编码器的列表。
 *  demuxer=demuxer\_name：打印名为demuxer\_name的解复用器的详细信息。使用-formats选项可获取所有多路分解器和多路复用器的列表。
 *  muxer=muxer\_name：打印名为muxer\_name的多路复用器的详细信息。使用-formats选项可获取所有多路复用器和多路分解器的列表。
 *  filter=filter\_name：打印名为*filter\_name*的过滤器的详细信息。使用-filters选项可获取所有过滤器的列表。
 *  bsf=bitstream\_filter\_name：打印名为bitstream\_filter\_name的位流过滤器的详细信息。使用-bsfs选项可获取所有比特流过滤器的列表。

\-version：显示version。

\-formats：显示可用格式（包括设备）。

\-demuxers：显示可用解复用器。

\-muxers：显示可用多路复用器。

\-devices：显示可用设备。

\-codecs：显示libavcodec已知的所有编解码器。

\-decoders：显示可用的解码器。

\-encoders：显示所有可用的编码器。

\-bsfs：显示可用的比特流过滤器。

\-protocols：显示可用的协议。

\-filters：显示可用的libavfilter过滤器。

\-pix\_fmts：显示可用的像素格式。

\-sample\_fmts：显示可用的样本格式。

\-layouts：显示频道名称和标准频道布局。

\-colors：显示颜色名称。

\-sources device\[,opt1=val1\[,opt2=val2\]…\]：显示自动检测到的输入设备的来源。某些设备可能会提供无法自动检测的与系统相关的源名称。不能假定返回的列表总是完整的。

ffmpeg -sources pulse,server=192.168.0.4

\-sinks device\[,opt1=val1\[,opt2=val2\]…\]：显示自动检测到的输出设备接收器。某些设备可能会提供无法自动检测到的与系统相关的接收器名称。不能假定返回的列表总是完整的。

ffmpeg -sinks pulse,server=192.168.0.4

\-loglevel \[flags+\]loglevel | -v \[flags+\]loglevel：设置库使用的日志记录级别和标志。可选标志前缀可以包含以下值：

**repeat**：指示不应将重复的日志输出压缩到第一行，并且将省略“最后消息重复n次”行。

**level**：指示日志输出应在每个消息行中添加一个“level”前缀。这可以用作原木着色的替代方法，例如将日志转储到文件时。

还可以通过添加“+” / “-”前缀来单独设置标志，以设置/重置单个标志，而不会影响其他标志或更改日志级别。同时设置标志和日志级别时，在最后一个标志值和日志级别之前应该有一个“+”分隔符。

loglevel是包含以下值之一的字符串或数字：

**“quiet, -8”**：什么都不显示；安静。

“**panic, 0**”：仅显示可能导致进程崩溃的致命错误，例如断言失败。目前尚无此功能。

“**fatal, 8**”：仅显示致命错误。这些都是错误，之后绝对无法继续执行该过程。

“**error, 16**”：显示所有错误，包括可以从中恢复的错误。

“**warning, 24**”：显示所有警告和错误。将显示与可能不正确或意外事件有关的任何消息。

“**info, 32**”：在处理过程中显示信息性消息。这是警告和错误的补充。这是默认值。

“**verbose, 40**”：与info相同，但更详细。

“**debug, 48**”：显示所有内容，包括调试信息。

“**trace, 56**”：

例如，要启用日志重复输出，需要添加“level”前缀，并将loglevel设置为详细：

ffmpeg -loglevel repeat+level+verbose -i input output

另一个示例，它允许重复的日志输出而不会影响级别前缀标志或日志级别的当前状态：

ffmpeg [...] -loglevel +repeat

默认情况下，程序记录到“stderr”。如果终端支持着色，则使用颜色标记错误和警告。可以通过设置环境变量AV\_LOG\_FORCE\_NOCOLOR禁用日志着色，也可以强制设置环境变量AV\_LOG\_FORCE\_COLOR。

\-report：存储完整的命令行和日志输出到当前目录中名为“program-YYYYMMDD-HHMMSS.log”的文件中。该文件对于错误报告很有用。它还意味着-loglevel调试。

将环境变量FFREPORT设置为任何值都具有相同的效果。如果值是用“:”分隔的key=value序列，则这些选项将影响报告； 如果选项值包含特殊字符或选项定界符“:”（请参阅ffmpeg-utils手册中的“引用和转义”部分），则必须对这些选项值进行转义。可以识别以下选项：

“file”：设置报告的文件名；‘％p’被扩展为程序的名称，‘％t’被扩展为时间戳，‘%%’被扩展为普通‘％’。

“level”：使用数值设置详细级别（请参见-loglevel）。

例如，使用日志级别32（日志级别info）将报告输出到名为ffreport.log的文件：

FFREPORT=file=ffreport.log:level=32 ffmpeg -i input output

解析环境变量中的错误不是致命的，不会出现在报告中。

\-hide\_banner：禁止打印横幅。

\-cpuflags flags (*global*)：允许设置和清除CPU标志。此选项用于测试。除非您知道自己在做什么，否则请勿使用它。

ffmpeg -cpuflags -sse+mmx ...
    ffmpeg -cpuflags mmx ...
    ffmpeg -cpuflags 0 ...

该选项的可能标志是：

“**x86**”：‘mmx’，‘mmxext’，‘sse’，‘sse2’，‘sse2slow’，‘sse3’，‘sse3slow’，‘ssse3’，‘atom’，‘sse4.1’，‘sse4.2’，‘avx’，‘avx2’，‘xop’，‘fma3’，‘fma4’，‘3dnow’，‘3dnowext’，‘bmi1’，‘bmi2’，‘cmov’

“**ARM**”：‘armv5te’，‘armv6’，‘armv6t2’，‘vfp’，‘vfpv3’，‘neon’，‘setend’

“**AArch64**”：‘armv8’，‘vfp’，‘neon’

“**PowerPC**”：‘**altivec**’

“**Specific Processors**”：‘pentium2’，‘pentium3’，‘pentium4’，‘k6’，‘k62’，‘athlon’，‘athlonxp’，‘k8’

3）AVOptions

这些选项由libavformat，libavdevice和libavcodec库直接提供。要查看可用AVOptions的列表，请使用-help选项。它们分为两类：

generic：可以为任何容器，编解码器或设备设置这些选项。 通用选项在容器/设备的AVFormatContext选项下和编解码器的AVCodecContext选项下列出。

private：这些选项特定于给定的容器，设备或编解码器。专用选项在其相应的容器/设备/编解码器下列出。

例如，要将ID3v2.3标头而不是默认ID3v2.4写入MP3文件，使用MP3多路复用器的id3v2\_version私有选项：

ffmpeg -i input.flac -id3v2_version 3 out.mp3

所有编解码器AVOptions都是按流的，因此应将流说明符附加到它们：

ffmpeg -i multichannel.mxf -map 0:v:0 -map 0:a:0 -map 0:a:0 -c:a:0 ac3 -b:a:0 640k -ac:a:1 2 -c:a:1 aac -b:2 128k out.mp4

在上面的示例中，多通道音频流被映射两次以进行输出。第一个实例使用编解码器ac3和比特率640k进行编码。 第二个实例降混到2个通道，并使用编解码器aac进行编码。使用输出流的绝对索引为其指定了128k的比特率。

4）Main options

\-f format：强制使用格式。

\-unit：显示值的单位。

\-prefix：使用SI前缀作为显示值。除非使用“-byte\_binary\_prefix”选项，否则所有前缀均为十进制。

\-byte\_binary\_prefix：强制对字节值使用二进制前缀。

\-sexagesimal：使用十六进制格式HH:MM:SS.MICROSECONDS作为时间值。

\-pretty：美化显示值的格式，它对应于选项“-unit -prefix -byte\_binary\_prefix -sexagesimal”。

\-of, -print\_format writer\_name\[=writer\_options\]：设置输出打印格式。

writer\_name指定编写者的名称，writer\_options指定要传递给编写者的选项。

例如，以JSON格式打印输出：

-print_format json

\-sections：打印section的结构和section信息，然后退出。输出并不意味着要由机器解析。

\-select\_streams stream\_specifier：仅选择stream\_specifier指定的流。此选项仅影响与流相关的选项（例如show\_streams，show\_packets等）。例如，仅显示音频流，可以使用以下命令：

ffprobe -show_streams -select_streams a INPUT

仅显示属于索引1的视频流的视频数据包：

ffprobe -show_packets -select_streams v:1 INPUT

\-show\_data：显示有效载荷数据，为十六进制和ASCII转储。与-show\_packets结合使用，它将转储数据包的数据。与-show\_streams结合使用，它将转储编解码器额外数据。

转储将打印为“data”字段。它可能包含换行符。

\-show\_data\_hash algorithm：显示有效载荷数据的散列，具有-show\_packets的数据包以及具有-show\_streams的编解码器额外数据。

\-show\_error：显示有关尝试探查输入时发现的错误的信息。错误信息将打印在名称为“ERROR”的区域中。

\-show\_format：显示有关输入多媒体流的容器格式的信息。所有容器格式信息都打印在名称为“FORMAT”的部分中。

\-show\_format\_entry name：与-show\_format类似，但仅显示容器格式信息的指定条目，而不是全部。可以多次给此选项，然后将显示所有指定的条目。不建议使用此选项，请改用show\_entries。

\-show\_entries section\_entries：设置要显示的条目列表。根据*section\_entries*指定条目。section\_entries包含以“:”分隔的节条目列表。每个部分条目均由一个部分名称（或唯一名称）组成，还可以选择在该部分本地的条目列表之后，以“,”分隔。

如果指定了节名称，但后没有跟“=”，则所有条目以及所有包含的节将被打印输出。否则，仅打印在本地部分条目列表中指定的条目。如果指定了“=”，但本地条目列表为空，则该部分将不会显示任何条目。

请注意，本地节条目的指定顺序在输出中不遵守，并且将保留通常的显示顺序。

形式语法如下：

LOCAL_SECTION_ENTRIES ::= SECTION_ENTRY_NAME[,LOCAL_SECTION_ENTRIES]
    SECTION_ENTRY         ::= SECTION_NAME[=[LOCAL_SECTION_ENTRIES]]
    SECTION_ENTRIES       ::= SECTION_ENTRY[:SECTION_ENTRIES]

例如，要仅显示每个流的索引和类型以及数据包的PTS时间，持续时间和流索引，可以指定参数：

packet=pts_time,duration_time,stream_index : stream=index,codec_type

要显示“format”部分中的所有条目，但仅显示“流”部分中的编解码器类型，请指定参数：

format : stream=codec_type

要显示流和格式部分中的所有标签：

stream_tags : format_tags

要仅在流部分中显示“title”标签（如果有）：

stream_tags=title

\-show\_packets：显示有关输入多媒体流中包含的每个数据包的信息。每个单个数据包的信息都打印在名称为“PACKET”的专用部分中。

\-show\_frames：显示有关输入多媒体流中包含的每个帧和字幕的信息。每个单帧的信息都打印在名称为“FRAME”或“SUBTITLE”的专用部分中。

\-show\_log loglevel：根据在loglevel中设置的值，显示来自解码器的有关每个帧的日志信息（请参阅-loglevel）。此选项需要-show\_frames。每个日志消息的信息都打印在名称为“LOG”的专用部分中。

\-show\_streams：显示有关输入多媒体流中包含的每个媒体流的信息。每个媒体流信息都打印在名为“STREAM”的专用部分中。