GStreamer播放教程07——自定义playbin2的sink

目标

通过手动选择音频和视频的sink，playbin2可以进一步定制。这允许使用playbin2的应用在解码后可以自行做最终的渲染和显示。本教程展示了：

如何替换playbin2选择的sink

如何使用一个复杂的pipeline来作为sink

介绍

playbin2有两个属性：audio-sink和video-sink。应用只需要实例化合适的element然后通过这两个属性传给playbin2就行了。

这个方法只能使用一个简单地element来做sink。如果遇到的情况不是简单地element而是一个复杂的pipeline呢（比如均衡器加一个音频sink），就需要用Bin来包装一下，让playbin2感觉还是一个element。

一个Bin就是一个容器，可以容纳一部分的pipeline，但操作的时候作为一个element。例如，我们在所有教程里面用得GstPipeline就是一个不会和外面的element做交互的GstBin。在Bin里面的element通过虚拟Pad（Ghost Pads）来和外面的element交互。这也就是说，Bin上得一个pad仅仅实现把外面的element上的pad的数据传到内部的element的pad上。



GstBin也是element的一类，所以element可以用的地方，Bin也都能用，特别是，可以作为playbin2的sink。

一个均衡的播放器

#include <gst/gst.h>

int main(int argc, char *argv[]) {
GstElement *pipeline, *bin, *equalizer, *convert, *sink;
GstPad *pad, *ghost_pad;
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);

/* Create the elements inside the sink bin */
equalizer = gst_element_factory_make ("equalizer-3bands", "equalizer");
convert = gst_element_factory_make ("audioconvert", "convert");
sink = gst_element_factory_make ("autoaudiosink", "audio_sink");
if (!equalizer || !convert || !sink) {
g_printerr ("Not all elements could be created.\n");
return -1;
}

/* Create the sink bin, add the elements and link them */
bin = gst_bin_new ("audio_sink_bin");
gst_bin_add_many (GST_BIN (bin), equalizer, convert, sink, NULL);
gst_element_link_many (equalizer, convert, sink, NULL);
pad = gst_element_get_static_pad (equalizer, "sink");
ghost_pad = gst_ghost_pad_new ("sink", pad);
gst_pad_set_active (ghost_pad, TRUE);
gst_element_add_pad (bin, ghost_pad);
gst_object_unref (pad);

/* Configure the equalizer */
g_object_set (G_OBJECT (equalizer), "band1", (gdouble)-24.0, NULL);
g_object_set (G_OBJECT (equalizer), "band2", (gdouble)-24.0, NULL);

/* Set playbin2's audio sink to be our sink bin */
g_object_set (GST_OBJECT (pipeline), "audio-sink", bin, 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;
}

工作流程

/* Create the elements inside the sink bin */
equalizer = gst_element_factory_make ("equalizer-3bands", "equalizer");
convert = gst_element_factory_make ("audioconvert", "convert");
sink = gst_element_factory_make ("autoaudiosink", "audio_sink");
if (!equalizer || !convert || !sink) {
g_printerr ("Not all elements could be created.\n");
return -1;
}

生成所有的sink bin所需要的element。我们使用了一个equalizer-3bands和一个autoaudiosink，中间还用audioconvert连接起来。

/* Create the sink bin, add the elements and link them */
bin = gst_bin_new ("audio_sink_bin");
gst_bin_add_many (GST_BIN (bin), equalizer, convert, sink, NULL);
gst_element_link_many (equalizer, convert, sink, NULL);

这几句把新的element加到Bin里面然后连接起来，就和在pipeline中一样。

pad = gst_element_get_static_pad (equalizer, "sink");
ghost_pad = gst_ghost_pad_new ("sink", pad);
gst_pad_set_active (ghost_pad, TRUE);
gst_element_add_pad (bin, ghost_pad);
gst_object_unref (pad);

现在我们需要生成虚拟Pad，这也一部分在Bin里面的pipeline可以连接到外面。这个虚拟Pad会和内部的一个element的Pad连接起来，我们会用gst_element_get_static_pad()来获得这个Pad。如果是一个RequestPad而不是Always Pad的话，那么我们就用get_element_request_pad()方法，具体请参考《GStreamer基础教程07——多线程和Pad的有效性》

虚拟Pad用gst_ghost_pad_new()来创建，用gst_pad_set_active()来激活。然后用gst_element_add_pad()来加入Bin。

最后，我们用gst_object_unref()来释放获得的均衡器的sink pad。

在这点上，我们有一个有sink功能的Bin，可以在playbin2里面用作音频sink，我们只需要设置一下playbin2的相关属性就行了。

/* Set playbin2's audio sink to be our sink bin */
g_object_set (GST_OBJECT (pipeline), "audio-sink", bin, NULL);

这和用一个sink element设置playbin2的audio-sink属性是完全一样的。

/* Configure the equalizer */
g_object_set (G_OBJECT (equalizer), "band1", (gdouble)-24.0, NULL);
g_object_set (G_OBJECT (equalizer), "band2", (gdouble)-24.0, NULL);

剩下的就是均衡器的配置了。在这个例子中，两个高频波段设置了最大的衰减，这样就增强了低音修改不同的值来实际看看效果。