Bin:
bin 是一个容器元素。您可以将 element 元素添加到 bin 中。由于 bin 本身就是一个元素,因此 bin 可以像任何其他元素一样处理。因此,上一章 (element)的操作也适用于 bin。
什么是bin:
bin 允许您将一组链接起来的元素合并为一个逻辑元素。您不再处理每一个元素,而只处理一个 bin 元素。我们会发现这非常强大,当你想要构建一个复杂的 pipeline 管道时,你可以将 pipeline 管道分解成一个个小一点的块。
bin 还将管理其中包含的元素。它将对其内部的所有元素执行状态变更,以及收集和转发总线消息。
GStreamer 程序员可以使用一种特殊类型的 bin:
- pipeline:管理所包含元素的同步和总线消息的通用容器。顶层 bin 必须是一个 pipeline,因此每个应用程序至少需要一个 pipeline。
创建 bin:
bin 的创建方式与其他元素的创建方式相同,即使用 element factory 元素工厂。还有一些方便的函数可用(gst_bin_new()
和 gst_pipeline_new()
)。可以使用 gst_bin_add()
和 gst_bin_remove()
将元素添加到 bin 或从 bin 中删除元素 。请注意,您添加元素的 bin 将获得该元素的所有权。如果销毁 bin,则元素将随之取消引用。如果从 bin 中删除元素,它也将自动取消引用。
basic-example-8.c
#include <stdio.h> #include <gst/gst.h> int main (int argc, char *argv[]) { GstElement *bin, *pipeline, *source, *sink; /* init */ gst_init (&argc, &argv); /* create */ pipeline = gst_pipeline_new ("my_pipeline"); bin = gst_bin_new ("my_bin"); source = gst_element_factory_make ("fakesrc", "source"); sink = gst_element_factory_make ("fakesink", "sink"); /* First add the elements to the bin */ gst_bin_add_many (GST_BIN (bin), source, sink, NULL); /* add the bin to the pipeline */ gst_bin_add (GST_BIN (pipeline), bin); /* link the elements */ gst_element_link (source, sink); [..] }
该示例并不是完整代码,不能运行,主要用于理解pipeline和bin的创建,和向bin中添加element元素。
有多种函数可用于在 bin 中查找元素。最常用的是 gst_bin_get_by_name()
和 gst_bin_get_by_interface()
。您还可以使用函数 gst_bin_iterate_elements()
迭代查找 bin 包含的所有元素。有关详细信息,请参阅 GstBin
的 API 参考。
自定义 bin:
应用程序程序员可以创建包含元素的自定义 bin 来执行特定任务。例如,这允许您仅使用以下代码行编写 Ogg/Vorbis 解码器:
basic-example-9.c
#include <stdio.h> #include <gst/gst.h> int main (int argc, char *argv[]) { GstElement *player; /* init */ gst_init (&argc, &argv); /* create player */ player = gst_element_factory_make ("oggvorbisplayer", "player"); /* set the source audio file */ g_object_set (player, "location", "helloworld.ogg", NULL); /* start playback */ gst_element_set_state (GST_ELEMENT (player), GST_STATE_PLAYING); [..] }
(当然,这是一个愚蠢的例子,已经存在一个更强大、更通用的自定义 bin,例如:playbin 元素。)
可以使用插件或从应用程序创建自定义 bin。您可以在 Plugin Writer's Guide 中找到有关创建自定义 bin 的更多信息
此类自定义 bin 的示例是 gst-plugins-base 中的 playbin 和 uridecodebin 元素。
bin管理其子项的状态:
bin 管理其中包含的所有元素的状态。如果使用 gst_element_set_state()
将 bin(或管道,这是一种特殊的顶级 bin)设置为某个目标状态,它将确保其中包含的所有元素都将设置为此状态。这意味着通常只需要设置顶级 pipeline 管道的状态即可启动或关闭 pipeline 管道。
bin 将对其从 sink 元素到 source 元素的所有子元素执行状态更改,顺序也是先设置 sink,再设置 source。这可确保下游 element 元素在上游 element 元素被置于 PAUSED
或 PLAYING
状态时准备好接收数据。同样在关闭时,sink 元素将首先设置为 READY
或 NULL
,这会使上游 element 元素收到 FLUSHING
错误,会让 element 元素被设置为 READY
或 NULL
状态之前就停止流式处理线程了。
但请注意,如果将元素添加到已经在运行的 bin 或 pipeline 中,例如从 “pad-added” 信号回调中,element 元素状态不会自动与添加到的 bin 或 pipeline 的当前状态或目标状态保持一致。相反,当你向已经运行的pipeline中添加元素时,你需要使用 gst_element_set_state() 或
自行将其设置为所需的目标状态。gst_element_sync_state_with_parent()