要理解PPAPI插件的设计，先仔细阅读下面这些文章： - [**Chromium的Process Models**](http://www.chromium.org/developers/design-documents/process-models) - [**Chromium的Multi-process Architecture**](http://www.chromium.org/developers/design-documents/multi-process-architecture) - [**Chromium的Plugin Architecture**](http://www.chromium.org/developers/design-documents/plugin-architecture) - [**Pepper plugin implementation**](http://www.chromium.org/developers/design-documents/pepper-plugin-implementation) 理解了架构设计，再看代码层面的文档： - [**Important concepts for working with PPAPI**](https://code.google.com/p/ppapi/wiki/Concepts) - [**GettingStarted, Writing a simple plugin**](https://code.google.com/p/ppapi/wiki/GettingStarted) 有的链接需要翻墙，天朝的局域网，我爱死你了。 好啦，现在对PPAPI应该有基本的理解了。接下来我从代码角度来理解一下。 # Module、Instance、Interface HTML页面可以通过embed标签来嵌入一个插件，HTML页面被加载时，解析到embed标签，就会根据type属性定位我们注册的PPAPI插件，加载对应的插件库（DLL）。 当PPAPI的库文件（DLL）被加载到浏览器进程中时，一个Module就产生了。在代码中，通过PP_Module（定义在pp_module.h中）来表示，用于标识一个Module的PP_Module类型实际上是一个int32。Module的标识符通过PPP_InitializeModule函数传入。PPP_InitializeModule函数的原型如下： ~~~ int32_t PPP_InitializeModule(PP_Module module, PPB_GetInterface get_browser_interface) ; ~~~ 第一个参数就是浏览器分配给你的插件库文件的标识符（handle），一般你需要保存它，后续的有些API会用到。 所以，一个Module，仅仅标识了library。要想在浏览器上显示点什么，还需要从这个Module里创建一个实例，这个实例代表了我们可以看见并与之交互的网页对象。一个插件实例对象又有两个层面的属性，一个就是标示符，通过PP_Instance（32位整型）来表示；另外一个是用来操作实例对象的接口，用PPP_Instance表示（聚合了各种函数指针的结构体）。 PPAPI的plugin会导出PPP_GetInterface函数，其原型如下： ~~~ const void* PPP_GetInterface(const char* interface_name); ~~~ 当浏览器要为HTML页面创建插件实例时，会先调用PPP_GetInterface函数获取一个实例模板指针（可以理解为PPP_Instance的实例，类似一个类，实际上是一个定义了函数指针成员的结构体）。 PPP_GetInterface函数接受一个字符串名字，返回void*，浏览器拿到万能的void*后会根据名字转换为具体的PPP_instance接口，在后续使用中就通过PPP_instance接口来与插件实例交互（比如具体的创建、销毁等动作）。 简单的理解，就是PPP_GetInterface会返回能创建Instance的接口PPP_Instance，浏览器调用PPP_Instance来创建实例并与实例交互。 PPP_instance接口声明如下： ~~~ struct PPP_Instance_1_1 { PP_Bool (*DidCreate)(PP_Instance instance, uint32_t argc, const char* argn[], const char* argv[]); void (*DidDestroy)(PP_Instance instance); void (*DidChangeView)(PP_Instance instance, PP_Resource view); void (*DidChangeFocus)(PP_Instance instance, PP_Bool has_focus); PP_Bool (*HandleDocumentLoad)(PP_Instance instance, PP_Resource url_loader); }; ~~~ 如你所见，它就像一个类，DidCreate是构造函数指针，DidDestroy是析构函数指针。创建插件实例对象时，DidCreate会被调用，其第一个参数instance，就是浏览器分配给这个插件实例对象的句柄（32位整数），通常我们可以保存起来供后续的调用使用。具体的说明，可以看ppp_instance.h。 之前在[**VS2013编译最简单的PPAPI插件**](http://blog.csdn.net/foruok/article/details/50485461)中我们编译了stub插件，它的PPP_GetInterface函数返回NULL，所以，其实浏览器可以加载stub库文件，生成Module，但无法创建Instance。 要想实作一个有用的PPAPI plugin，必须在PPP_GetInterface中返回真实的PPP_instance接口。下面是graphics_2d_example.c里的PPP_GetInterface函数实现： ~~~ PP_EXPORT const void* PPP_GetInterface(const char* interface_name) { if (strcmp(interface_name, PPP_INSTANCE_INTERFACE) == 0) return &instance_interface; return NULL; } ~~~ 它返回的instance_interface，是这么定义的： ~~~ static PPP_Instance instance_interface = { &Instance_DidCreate, &Instance_DidDestroy, &Instance_DidChangeView, &Instance_DidChangeFocus, &Instance_HandleDocumentLoad }; ~~~ 如你所见，它是一个PPP_Instance，在定义时进行了初始化，把文件内实现的几个函数，赋值给了结构体的5个函数指针。 # 浏览器接口PPB_GetInterface PPAPI插件要与浏览器交互，也得先有渠道来获取浏览器的功能接口。浏览器提供了很多功能接口，比如PPB_INSTANCE_INTERFACE，PPB_IMAGEDATA_INTERFACE，PPB_GRAPHICS_2D_INTERFACE等。 这些宏都是字符串，浏览器提供的接口名字宏，以PPB_开头，插件提供的，以PPP_开头。 插件被加载时，模块初始化函数PPP_InitializeModule会被调用，其原型如下： ~~~ int32_t PPP_InitializeModule(PP_Module module_id, PPB_GetInterface get_browser_interface); ~~~ 注意第二个参数，get_browser_interface，它的类型是PPB_GetInterface，是一个函数指针，定义如下： ~~~ typedef const void* (*PPB_GetInterface)(const char* interface_name); ~~~ 如你所见，这是一个接受一个字符串参数返回void*的函数指针。插件可以在PPP_InitializeModule被调用时保存第一个参数，用它来获取浏览器提供的各种接口。根据接口名字，把返回的void*强制转换为对应的接口来使用。参看graphics_2d_example.c里的实现： ~~~ PP_EXPORT int32_t PPP_InitializeModule(PP_Module module, PPB_GetInterface get_browser_interface) { g_get_browser_interface = get_browser_interface; g_core_interface = (const PPB_Core*) get_browser_interface(PPB_CORE_INTERFACE); g_instance_interface = (const PPB_Instance*) get_browser_interface(PPB_INSTANCE_INTERFACE); g_image_data_interface = (const PPB_ImageData*) get_browser_interface(PPB_IMAGEDATA_INTERFACE); g_graphics_2d_interface = (const PPB_Graphics2D*) get_browser_interface(PPB_GRAPHICS_2D_INTERFACE); g_view_interface = (const PPB_View*) get_browser_interface(PPB_VIEW_INTERFACE); if (!g_core_interface || !g_instance_interface || g_image_data_interface || !g_graphics_2d_interface || !g_view_interface) return -1; return PP_OK; } ~~~ 当我们拿到了浏览器暴露的各种接口，就可以做想干的事情了。 对于PPAPI插件的设计，先理解到这里，下次我们看插件的加载与使用流程、如何绘图、如何处理交互。 相关文章参考： - [**CEF Windows开发环境搭建**](http://blog.csdn.net/foruok/article/details/50468642) - [**CEF加载PPAPI插件**](http://blog.csdn.net/foruok/article/details/50485448) - [**VS2013编译最简单的PPAPI插件**](http://blog.csdn.net/foruok/article/details/50485461)