GStreamer基础教程之GStreamer工具

最新推荐文章于 2024-08-13 21:34:47 发布

m_wordPlan

最新推荐文章于 2024-08-13 21:34:47 发布

阅读量1.8k

点赞数

原文链接：https://gstreamer.freedesktop.org/documentation/tutorials/basic/gstreamer-tools.html?gi-language=c#gstlaunch10

版权

目标

GStreamer自带了一些使用方便和完全必要的工具。本教程无代码，并且教我们如下内容：

如何在不适用C语言，使用命令行来构建并运行GStreamer管道。
如何找出GStreamer可用的元素及其相应元素的capabilities.
如何发现媒体文件的内部结构。

介绍

这些工具位于 GStreamer 二进制文件的 bin 目录中。所以，如果想执行这些工具，除了将此目录添加到系统环境变量($PATH)，否则只能在bin目录中命令行执行相关工具。

为了允许GStreamer多版本在同一个系统中共存，这些工具已经版本化，即：一个GStreamer版本号取决于他们的名称。当前版本是基于GStreamer 1.0,所以这些工具被叫做 gst-launch-1.0, gst-inspect-1.0 和 gst-discoverer-1.0 。

gst-launch-1.0

此工具接受管道的文本描述，将文本管道实例化，并将管道设置为 PLAYING 状态。它允许你在使用GStreamer API 构建实际实现的管道之前，去快速的检查这个给出的管道是否工作(ps[译者理解]：意思是在使用GStreamer API构建管道前，可以使用gst-launch-1.0命令检验已经给出的管道是否可用)。

请记住，它只能创建简单的管道。特别是，它只能模拟管道与应用程序的交互到一定程度。在任何情况下，快速测试管道都非常方便，世界各地的 GStreamer 开发人员每天都在使用它。

请注意 gst-launch-1.0 主要是开发人员的调试工具。不应该在它之上构建应用程序。相反，使用 GStreamer API 的 gst_parse_launch() 函数作为从管道描述构建管道的简单方法。

虽然构建管道描述的规则非常简单，但多个元素的串联可以很快使这种描述类似于黑魔法。不要害怕，因为每个人最终都会学习 gst-launch-1.0 语法。

gst-launch-1.0 的命令行包含一个选项列表，后跟一个 PIPELINE-DESCRIPTION。接下来给出了一些简化的说明，请参阅 gst-launch-1.0 参考页面上的完整文档。

Elements

简单来说，PIPELINE-DESCRIPTION 是由感叹号 (!) 分隔的元素类型列表。继续并输入以下命令：

gst-launch-1.0 videotestsrc ! videoconvert ! autovideosink

您应该会看到一个带有动画视频模式的窗口。在终端上使用 CTRL+C 停止程序。

这实例化了一个 videotestsrc 类型的新元素（一个生成样本视频模式的元素），一个 videoconvert（一个进行原始视频格式转换的元素，确保其他元素可以相互理解）,和一个自动视频接收器（呈现视频的窗口）。然后，GStreamer 尝试将每个元素的输出链接到描述中出现在其右侧的元素的输入。如果有多个输入或输出Pad可用，则使用Pad Caps来查找两个兼容的Pads。

Properties

属性可以附加到元素，格式为 *property=value *（可以指定多个属性，用空格分隔）。使用 gst-inspect-1.0 工具（接下来解释）找出元素的可用属性。

gst-launch-1.0 videotestsrc pattern=11 ! videoconvert ! autovideosink

会看到如上的一个由圆圈组成的静态视频模式。

Named elements

元素可以使用 name 属性命名，这样可以创建涉及分支的复杂管道。名称允许链接到之前在描述中创建的元素，并且对于使用具有多个输出pad的元素是必不可少的，像demuxer 或tee,例如：

gst-launch-1.0 videotestsrc ! videoconvert ! tee name=t ! queue ! autovideosink t. ! queue ! autovideosink

您应该看到两个视频窗口，显示相同的示例视频模式。如果您只看到一个，请尝试移动它，因为它可能位于第二个窗口的顶部。
这个示例实例化了一个videotestsrc，链接到一个videoconvert，链接到一个tee(请记住在Basic教程7:多线程和Pad可用性中，tee将通过其输入Pad传入的所有内容复制到其每个输出Pad)。tee被简单地命名为“t”(使用name属性)，然后链接到队列和自动视频接收器。同样的t指的是't.'(注意'.')，然后链接到第二个队列和第二个自动视频接收器。

Pads

与其让 GStreamer 在链接两个元素时选择使用哪个 Pad，不如直接指定 Pad。您可以通过在元素名称后添加一个点和 Pad 名称来实现(这个元素必须是一个命名元素)。使用 gst-inspect-1.0 工具了解元素的 Pads 名称。

这很有用，例如，当您想从 demuxer 中检索一个特定的流时：

gst-launch-1.0 souphttpsrc location=https://www.freedesktop.org/software/gstreamer-sdk/data/media/sintel_trailer-480p.webm ! matroskademux name=d d.video_0 ! matroskamux ! filesink location=sintel_video.mkv

这使用 souphttpssrc 从互联网获取媒体文件，该文件采用 webm 格式（一种特殊的 Matroska 容器）然后我们使用 matroskademux 打开容器。该媒体包含音频和视频，因此 matroskademux 将创建两个输出 Pad，分别命名为 video_0 和 audio_0。我们将 video_0 链接到 matroskamux 元素以将视频流重新打包到一个新容器中，最后将其链接到一个文件接收器，后者会将流写入名为“sintel_video.mkv”的文件（位置属性指定文件名）。

总而言之，我们采用了一个 webm 文件，去除了音频，并生成了一个带有视频的新 matroska 文件。如果我们只想保留音频：

gst-launch-1.0 souphttpsrc location=https://www.freedesktop.org/software/gstreamer-sdk/data/media/sintel_trailer-480p.webm ! matroskademux name=d d.audio_0 ! vorbisparse ! matroskamux ! filesink location=sintel_audio.mka

请求 vorbisparse 元素从流中提取一些信息并将其放入 Pad Caps 中，因此下一个元素 matroskamux 知道如何处理流。在视频的情况下，这不是必需的，因为 matroskademux 已经提取了此信息并将其添加到 Caps。

请注意，在上述两个示例中，没有媒体被解码或播放。我们刚刚从一个容器移动到另一个容器（再次解复用和重新复用）。

Caps filters

当一个元素有多个输出pad时，可能会发生下一个元素的链接不明确的情况：下一个元素可能有多个兼容的输入pad，或者其输入pad可能与所有输出pad的 Pad Caps 兼容。在这种情况下，GStreamer 将使用第一个可用的 pad 进行链接，这几乎等于说 GStreamer 将随机选择一个输出 pad。

考虑以下管道：

gst-launch-1.0 souphttpsrc location=https://www.freedesktop.org/software/gstreamer-sdk/data/media/sintel_trailer-480p.webm ! matroskademux ! filesink location=test

这与上一个示例中的媒体文件和解复用器相同。 filesink 的输入 Pad Caps 是 ANY，这意味着它可以接受任何类型的媒体。matroskademux 的两个输出pad中的哪一个将链接到文件接收器？video_0 还是audio_0？你不可能知道。

但是，您可以通过使用named pads（如上一小节中所述）或使用Caps Filters来消除这种歧义：

gst-launch-1.0 souphttpsrc location=https://www.freedesktop.org/software/gstreamer-sdk/data/media/sintel_trailer-480p.webm ! matroskademux ! video/x-vp8 ! matroskamux ! filesink location=sintel_video.mkv

Caps 过滤器的行为就像一个传递元素，它什么都不做，只接受具有给定 Caps 的媒体，有效地解决了歧义。在这个例子中，在 matroskademux 和 matroskamux 之间我们添加了一个 video/x-vp8 Caps Filter 来指定我们对 matroskademux 的输出垫感兴趣，它可以产生这种视频。

要找出元素接受和生成的 Caps，请使用 gst-inspect-1.0 工具。要找出特定文件中包含的大写字母，请使用 gst-discoverer-1.0 工具。要找出元素为特定管道生成的 Caps，请照常运行 gst-launch-1.0，并使用 –v 选项打印 Caps 信息。

Examples

使用playbin 显示一个媒体文件：

gst-launch-1.0 playbin uri=https://www.freedesktop.org/software/gstreamer-sdk/data/media/sintel_trailer-480p.webm

一个完全操作的播放管道，带有音频和视频（或多或少与 playbin 将在内部创建的管道相同）：

gst-launch-1.0 souphttpsrc location=https://www.freedesktop.org/software/gstreamer-sdk/data/media/sintel_trailer-480p.webm ! matroskademux name=d ! queue ! vp8dec ! videoconvert ! autovideosink d. ! queue ! vorbisdec ! audioconvert ! audioresample ! autoaudiosink

一个转码管道，它打开 webm 容器并解码两个流（通过 uridecodebin），然后使用不同的编解码器重新编码音频和视频分支，并将它们放回 Ogg 容器中（只是为了它）。

gst-launch-1.0 uridecodebin uri=https://www.freedesktop.org/software/gstreamer-sdk/data/media/sintel_trailer-480p.webm name=d ! queue ! theoraenc ! oggmux name=m ! filesink location=sintel.ogg d. ! queue ! audioconvert ! audioresample ! flacenc ! m.

重新缩放管道。只要输入和输出上限中的帧大小不同，videoscale 元素就会执行重新缩放操作。输出上限由上限过滤器设置为 320x200。

gst-launch-1.0 uridecodebin uri=https://www.freedesktop.org/software/gstreamer-sdk/data/media/sintel_trailer-480p.webm ! queue ! videoscale ! video/x-raw-yuv,width=320,height=200 ! videoconvert ! autovideosink

gst-launch-1.0 的简短描述应该足以让您入门。请记住，您可以在获得完整的文档。

gst-inspect-1.0

这个工具有三种操作模式：

不带参数，它会列表出所有有效元素类型，也就是说，您可以用来实例化新元素的类型。
以文件名作为参数，它将文件视为一个Gstreamer插件，尝试打开它并列出其中描述的所有元素。
以元素名作为参数，则它会列出这个元素的所有信息。

让我们看三种模式中的一个例子：

gst-inspect-1.0 vp8dec

Factory Details:
  Rank                     primary (256)
  Long-name                On2 VP8 Decoder
  Klass                    Codec/Decoder/Video
  Description              Decode VP8 video streams
  Author                   David Schleef <ds@entropywave.com>, Sebastian Dröge <sebastian.droege@collabora.co.uk>

Plugin Details:
  Name                     vpx
  Description              VP8 plugin
  Filename                 /usr/lib64/gstreamer-1.0/libgstvpx.so
  Version                  1.6.4
  License                  LGPL
  Source module            gst-plugins-good
  Source release date      2016-04-14
  Binary package           Fedora GStreamer-plugins-good package
  Origin URL               http://download.fedoraproject.org

GObject
 +----GInitiallyUnowned
       +----GstObject
             +----GstElement
                   +----GstVideoDecoder
                         +----GstVP8Dec

Pad Templates:
  SINK template: 'sink'
    Availability: Always
    Capabilities:
      video/x-vp8

  SRC template: 'src'
    Availability: Always
    Capabilities:
      video/x-raw
                 format: I420
                  width: [ 1, 2147483647 ]
                 height: [ 1, 2147483647 ]
              framerate: [ 0/1, 2147483647/1 ]


Element Flags:
  no flags set

Element Implementation:
  Has change_state() function: gst_video_decoder_change_state

Element has no clocking capabilities.
Element has no URI handling capabilities.

Pads:
  SINK: 'sink'
    Pad Template: 'sink'
  SRC: 'src'
    Pad Template: 'src'

Element Properties:
  name                : The name of the object
                        flags: readable, writable
                        String. Default: "vp8dec0"
  parent              : The parent of the object
                        flags: readable, writable
                        Object of type "GstObject"
  post-processing     : Enable post processing
                        flags: readable, writable
                        Boolean. Default: false
  post-processing-flags: Flags to control post processing
                        flags: readable, writable
                        Flags "GstVP8DecPostProcessingFlags" Default: 0x00000403, "mfqe+demacroblock+deblock"
                           (0x00000001): deblock          - Deblock
                           (0x00000002): demacroblock     - Demacroblock
                           (0x00000004): addnoise         - Add noise
                           (0x00000400): mfqe             - Multi-frame quality enhancement
  deblocking-level    : Deblocking level
                        flags: readable, writable
                        Unsigned Integer. Range: 0 - 16 Default: 4
  noise-level         : Noise level
                        flags: readable, writable
                        Unsigned Integer. Range: 0 - 16 Default: 0
  threads             : Maximum number of decoding threads
                        flags: readable, writable
                        Unsigned Integer. Range: 1 - 16 Default: 0

gst-discoverer-1.0

此工具是 GstDiscoverer 对象的包装器。它接受来自命令行的 URI 并打印有关 GStreamer 可以提取的媒体的所有信息。找出用于制作媒体的容器和编解码器，以及您需要将哪些元素放入管道中来播放它，这很有用。

使用 gst-discoverer-1.0 --help 获取可用选项列表，这些选项基本上控制输出的详细程度。

我们看个例子：

gst-discoverer-1.0 https://www.freedesktop.org/software/gstreamer-sdk/data/media/sintel_trailer-480p.webm -v

Analyzing https://www.freedesktop.org/software/gstreamer-sdk/data/media/sintel_trailer-480p.webm
Done discovering https://www.freedesktop.org/software/gstreamer-sdk/data/media/sintel_trailer-480p.webm
Topology:
  container: video/webm
    audio: audio/x-vorbis, channels=(int)2, rate=(int)48000
      Codec:
        audio/x-vorbis, channels=(int)2, rate=(int)48000
      Additional info:
        None
      Language: en
      Channels: 2
      Sample rate: 48000
      Depth: 0
      Bitrate: 80000
      Max bitrate: 0
      Tags:
        taglist, language-code=(string)en, container-format=(string)Matroska, audio-codec=(string)Vorbis, application-name=(string)ffmpeg2theora-0.24, encoder=(string)"Xiph.Org\ libVorbis\ I\ 20090709", encoder-version=(uint)0, nominal-bitrate=(uint)80000, bitrate=(uint)80000;
    video: video/x-vp8, width=(int)854, height=(int)480, framerate=(fraction)25/1
      Codec:
        video/x-vp8, width=(int)854, height=(int)480, framerate=(fraction)25/1
      Additional info:
        None
      Width: 854
      Height: 480
      Depth: 0
      Frame rate: 25/1
      Pixel aspect ratio: 1/1
      Interlaced: false
      Bitrate: 0
      Max bitrate: 0
      Tags:
        taglist, video-codec=(string)"VP8\ video", container-format=(string)Matroska;

Properties:
  Duration: 0:00:52.250000000
  Seekable: yes
  Tags:
      video codec: VP8 video
      language code: en
      container format: Matroska
      application name: ffmpeg2theora-0.24
      encoder: Xiph.Org libVorbis I 20090709
      encoder version: 0
      audio codec: Vorbis
      nominal bitrate: 80000
      bitrate: 80000