Gstreamer官方教程汇总1---Hello World

这个教程是建立在已经安装并配置好gstreamer sdk的基础上的，如果没有安装好gstreamer sdk，请参看：

http://docs.gstreamer.com/display/GstSDK/Installing+the+SDK

代码及操作示例

将下面代码copy到一个命名为basic-tutorial-1.c的文件中。

#include <gst/gst.h>int main(int argc, char *argv[]) {GstElement *pipeline;GstBus *bus;GstMessage *msg;/* Initialize GStreamer */gst_init (&argc, &argv);/* Build the pipeline */pipeline = gst_parse_launch ("playbin2 uri=http://docs.gstreamer.com/media/sintel_trailer-480p.webm", NULL);/* Start playing */gst_element_set_state (pipeline, GST_STATE_PLAYING);/* Wait until error or EOS */bus = gst_element_get_bus (pipeline);msg = gst_bus_timed_pop_filtered (bus, GST_CLOCK_TIME_NONE, GST_MESSAGE_ERROR | GST_MESSAGE_EOS);/* Free resources */if (msg != NULL)gst_message_unref (msg);gst_object_unref (bus);gst_element_set_state (pipeline, GST_STATE_NULL);gst_object_unref (pipeline);return 0;
}

在终端输入：

gcc basic-tutorial-1.c -o basic-tutorial-1 `pkg-config --cflags --libs gstreamer-0.10`

正常会生成basic-tutorial-1这样一个可执行文件，但如果提示没有gst/gst.h文件，则需要先安装好执行环境：

sudo yum install gstreamer-devel

执行：

./basic-tutorial-1

就可以看到效果了。

逐步解说

/* Initialize GStreamer */
gst_init (&argc, &argv);

• 初始化所有的内部结构

• 检查插件是否可用

• 执行用于gstreamer的命令参数

  
  

/* Build the pipeline */
pipeline = gst_parse_launch ("playbin2 uri=http://docs.gstreamer.com/media/sintel_trailer-480p.webm", NULL);

这行代码是教程的核心，有两点需要说明：gst_parse_launch() 和 playbin2。

gst_parse_launch

GStreamer是设计用来处理多媒体流的框架。从“source”元素（生产者），下至“sink”要素（消费者）媒体传播，通过一系列执行各种任务的中间元素。该集合中的所有相互连接的元件被称为“pipeline(管道)”。

GStreamer中你通常是由手工组装的各个元素打造的管道，但是，当管道是很容易的，你不需要任何先进的功能，你可以把快捷方式：gst_parse_launch()。

这个函数接受一个管道的文本表示并把它变成一个实际的管道，这是非常方便的。事实上，这个功能是如此得心应手它周围有完全建立了一个工具，你会得到非常熟悉（请参Basic tutorial 10: GStreamer tools来了解gst-launch和gst-launch语法）。

playbin2

那么，什么样的管道是我们要求gst_parse_launch（）来构建我们呢？下面进入第二个关键点：我们正在建立一个名为playbin2单一元素组成的管道。

playbin2是充当source和sink一个特殊的元素（element），并且能够实现整个管道。在内部，它创建并连接所有必要的元素来播放媒体，所以你不必担心它。

它不允许元操作，像一个手动管道能做到的，但是，它仍然允许足够广泛的支持自己定制应用。包括本教程。

在这个例子中，我们只传递一个参数来playbin2，这是我们要播放的媒体的URI。试着将其更改到别的东西！无论是http://或file :/ / URI，playbin2将实例化适当的GStreamer source！

如果您输入了错误的URI，或者该文件不存在，或者你缺少一个插件，GStreamer中提供了多种通知机制，但是我们正在做的这个例子中，唯一一件事就是退出的错误，所以不要指望多的反馈。

/* Start playing */
gst_element_set_state (pipeline, GST_STATE_PLAYING);

这条线突出了另一个有趣的概念：状态。 GStreamer的每一个元素（element）都有一个相关联的状态（state），您可以或多或少认为的播放/暂停按钮，在您的普通DVD播放机。现在，我只想说，除非你设置的管道为i播放状态，否则不会开始播放。

在这一行，gst_element_set_state（）是设置管道（我们的唯一元素，记不清了）为播放状态，从而开始播放。

/* Wait until error or EOS */
bus = gst_element_get_bus (pipeline);
gst_bus_timed_pop_filtered (bus, GST_CLOCK_TIME_NONE, GST_MESSAGE_ERROR | GST_MESSAGE_EOS);

 gst_element_get_bus（）获取管道的总线，以及gst_bus_timed_pop_filtered（）将阻塞，直到您收到错误或EOS（End-Of-Stream）。 GStreamer的概念：不要过多地担心这条线，GStreamer的总线在Basic tutorial 2: GStreamer concepts解释。

就是这样！从这时开始，GStreamer包办一切事情。当媒体到达终点（EOS），或遇到错误（请尝试关闭视频窗口，或拔掉网线），则执行将结束。该应用程序可以通过按Ctrl-C组合在控制台中停止。

Cleanup

/* Free resources */
if (msg != NULL)gst_message_unref (msg);
gst_object_unref (bus);
gst_element_set_state (pipeline, GST_STATE_NULL);
gst_object_unref (pipeline);

请务必留意你使用过的 方法，看看是否有你没有释放掉的对象。

在这里， gst_bus_timed_pop_filtered()返回一个message需要被释放，关于gst_message_unref()（更多请参看Basic tutorial 2: GStreamer concepts）；

gst_element_get_bus（）添加一个引用到必须用gst_object_unref（）释放的总线。设置pipeline设空将确保它释放已分配的资源（更多Basic tutorial 3: Dynamic pipelines）。最后，unreferencing管道会破坏它，和它的所有内容。

Conclusion

让我们回顾一下，今天所学的：

• 如何使用gst_init()初始化GStreamer。

• 如何使用gst_parse_launch()快速构建文字描述的管道。

• 如何使用playbin2创建一个自动播放的管道。

• 如何标示GStreamer的信号并使用 gst_element_set_state()开始播放（）。

• 如何高枕无忧，而GStreamer的包办，使用gst_element_get_bus() 和 gst_bus_timed_pop_filtered()。

接下来的教程将不断推出更多的GStreamer的基本元素，并告诉你如何手工创建一个管道。

很高兴你能阅读这篇教程，并从中学到些许东西，下面的教程我们再见。