gstreamer的source开发流程

Gstreamer SRC插件框架

1、GST_PLUGIN_DEFINE宏

这个宏定义了插件的版本、初始化入口函数等。
函数的定义如下：

static gboolean plugin_init(GstPlugin *plugin)
{
	GST_DEBUG_CATEGORY_INIT(xxx_debug, "名字", 0, "提示信息");
	return gst_element_register(plugin, "插件名", GST_RANK_NONE, GST_TYPE_XXX_src);
}

GST_DEBUG_CATEGORY_INIT宏有助于后期调试
并且xxx_debug需要使用GST_DEBUG_CATEGORY_STATIC(xxx_debug)定义
#define GST_CAT_DEFAULT xxx_debug宏是为了解决后面调用GST_DEBUG有默认的obj;
这是插件的入口。
gst启动时第一个调用的函数。
接下来是一个很重要宏

2、G_DEFINE_TYPE

G_DEFINE_TYPE(TN, T_n, T_P)
/*
 *		TN： Type name，这是用struct定义好的。
 *		T_n：前缀，插件的几个默认函数的前缀
 *		T_P：父类。
 */

G_DEFINE_TYPE(Gst_xxx_Src, gst_xxx_src, GST_TYPE_PUSH_SRC); 

通过以上宏定义之后，需要实现以下2个函数

void gst_xxx_src_init(Gst_xxx_Src *src);
void gst_xxx_src_class_init(Gst_xxx_SrcClass *klass)

/*
 * Gst_xxx_SrcClass需要自己定义
 * struct _Gst_xxx_SrcClass {
 *		GstPushSrcClass parent_class;
 * }
 * typedef _Gst_xxx_SrcClass Gst_xxx_SrcClass;
 */

3、gst_xxx_src_init

这个函数在插件初始化完之后第一个调用的函数。
在这个函数中可以初始化一些默认参数。
最后是一定全用
gst_base_src_set_format
如果是video视频采集之类的SRC
还需要调用
gst_base_src_live将basesrc的live设置为true.

4、gst_xxx_src_class_init

这个是对各个对象的初始化。
需要自己实现
set_property
get_property

set_caps
get_caps;
fixate
query
start
stop
decide_allocation
create
和一些其它默认的参数

接下来单独讲一个set_caps，decide_allocation和create两个方法。

5、set_caps

gboolean gst_xxx_set_caps(GstBaseSrc *bsrc, GstCaps *caps);

这个回调接口我一开始也没有怎么明白怎么使用。因为caps始终会有值传递过来。
我一时并没有明白过来这个值是怎么传来的。
偶然间才知道，这个caps是在gst调用时用

! format=xxx, framerate=30/1 width=1024 height=768

这样传递过来的。

6、decide_allocation

gboolean gst_xxx_decide_allocation(GstBaseSrc *bsrc, GstQuery *query)

这个函数只会调用一次。
在这个函数中，需要初始pool, buffer
并做必要的检查。

最后一个是

7、create

GstFlowReturn gst_xxx_create(GstPushSrc *psrc, GstBuffer **buf)

这个函数在整个插件运行中会反复被调用。
在这个函数中，需要分配buf，并返回GST_FLOW_OK;
这里需要注意的是，
buf只需要分配出来，并根据自己的需求和平台，对buf进行填充。
buf在下游会被map，copy和free。

最后：

---

根据官方的插件惯例，需要自己实现allocator。方便使用pool。

---