Doubango(2)：plugin结构

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);
}