doubango把功能划分为很多部件,如音视频的生产者producer,音视频的消耗者consumer,负责编解码的codec等。每个部件其实可以有不同的实现。如producer在不同平台上就有不同的实现,即使是同一平台,如音频的生产,也可以直接采集麦克风,或者从文件获取音频数据。
doubango通过插件的方式来管理这些不同的选择。
插件的定义
插件的定义在tinyMedia目录,而插件的具体实现在tinyDav目录。
以consumer部件为例。
首先在tinyMedia目录,定义了一个tmedia_consumer_t
结构,用于存放所有consumer插件都需要的一些公共数据。紧接着定义了tmedia_consumer_plugin_def_t
结构,用于描述插件应该支持的行为。tmedia_consumer_plugin_def_t
包含了具体插件的xx_def_t
(里面包含plugin的size和构造析构函数)的指针,以及应该支持的函数。
当定义一个具体的consumer插件时,如video_consumer_android_t
,需要直接或者间接继承tmedia_consumer_t
结构。并提供一个tmedia_consumer_plugin_def_t
全局变量来保存自己作为consumer_plugin提供的函数及其他信息。
static const tmedia_consumer_plugin_def_t video_consumer_android_plugin_def_s =
{
&video_consumer_android_def_s,
tmedia_video,
"ANDROID video consumer",
video_consumer_android_set,
tsk_null,
video_consumer_android_prepare,
video_consumer_android_start,
video_consumer_android_consume,
video_consumer_android_pause,
video_consumer_android_stop
};
const tmedia_consumer_plugin_def_t *video_consumer_android_plugin_def_t = &video_consumer_android_plugin_def_s;
插件的注册
tinyMedia里还提供了consumer插件的注册函数tmedia_consumer_plugin_register
。调用注册函数后,创建tmedia_consumer_t
时就可以创建该插件了。
插件的注册,放在tdav_init
函数中调用。
tmedia_consumer_plugin_register (audio_consumer_android_plugin_def_t);
部件的创建
tmedia_consumer_t
中有一个plugin(xxx_plugin_def_t类型)的变量。当调用tmedia_consumer_create
创建tmedia_consumer_t
时,会从已经注册的插件列表中,找到合适的插件,生成一个实例,作为tmedia_consumer_t
返回给调用方(插件是继承tmedia_consumer_t,还记得吗)。并把该插件的xxx_plugin_def_t赋值给plugin变量。
typedef struct tmedia_consumer_s
{
//其他变量
const struct tmedia_consumer_plugin_def_s* plugin;
} tmedia_consumer_t;
对部件的操作
现在对部件进行操作的时候,就可以委托给plugin的对应函数了。
这里的plugin
其实是regist的video_consumer_android_plugin_def_t
;
plugin->consume
就是video_consumer_android_consume
。
而tmedia_consumer_t *self
则是返回出去的video_consumer_android_t
对象。在video_consumer_android_consume
可以强转为video_consumer_android_t
类型。
int tmedia_consumer_consume (tmedia_consumer_t *self, const void *buffer, tsk_size_t size, tsk_object_t *proto_hdr)
{
if (!self || !self->plugin || !self->plugin->consume || !proto_hdr)
{
TSK_DEBUG_ERROR ("Invalid parameter");
return -1;
}
return self->plugin->consume (self, buffer, size, proto_hdr);
}