《NPAPI插件技术说明》.docx

NPAPI插件技术说明文档 ? 说明：该文档主要说明基于NPAPI标准进行开发浏览器插件的方法和开发环境等的相关说明。并以简单的例子实现在firefox、Opera和chrome浏览器上测试进行说明。主要说明原理性的内容。 ? 一、环境说明： VS2008 + xulrunner-7.en-US.win32.sdk SDK是firefox提供的，下载地址  HYPERLINK /en/docs/Gecko_SDK /en/docs/Gecko_SDK 需要用到firefox源码中的例子插件的一些源码文件：np_entry.cpp、npn_gate.cpp、npp_gate.cpp、basic.def、pluginbase.h、npplat.h、plugin.h等文件。 二、函数说明： NP_是npapi的插件库提供给浏览器的最上层的接口 NPP_即NP Plugin是插件本身提供给浏览器调用的接口，主要被用来填充NPPluginFuncs的结构体 NPN_即NP Netscape ,是浏览器提供给插件使用的接口，这些接口一般都在NPNetscapeFuncs结构体中 1)NP_XXX类函数 NP_XXX类接口一般为动态链接库的导出接口，主要有NP_Initialize、NP_GetMIMEDescription、?NP_GetEntryPoints、NP_GetValue、NP_Shutdown的等几个函数，不同平台的接口可能略有不同，但基本功能都是一样的，都是通过接口来初始化、销毁以及认知?此动态库。 详细的接口介绍请参照：  HYPERLINK /en/Gecko_Plugin_API_Reference:Plug-in_Side_Plug-in_API /en/Gecko_Plugin_API_Reference:Plug-in_Side_Plug-in_API ? 2)NPP_XXX类函数 NPP_XXX类接口一般为提供给浏览器引擎调用的接口，主要包括： NPP_New、NPP_Destroy、NPP_SetWindow、NPP_GetMIMEDescription?、NPP_NewStream、NPP_DestroyStream、NPP_StreamAsFile、NPP_WriteReady、NPP_Write、NPP_Print、NPP_HandleEvent、NPP_URLNotify、NPP_GetValue、NPP_SetValue等 详细的接口介绍请参照：  HYPERLINK /en/Gecko_Plugin_API_Reference:Plug-in_Side_Plug-in_API /en/Gecko_Plugin_API_Reference:Plug-in_Side_Plug-in_API ? 3)NPN_XXX类函数 NPN_XXX类接口一般为webkit引擎提供给plugin调用的接口主要包括： NPN_GetURL、NPN_PostURL、NPN_RequestRead、NPN_NewStream、NPN_Write、NPN_DestroyStream、NPN_Status、NPN_UserAgent、NPN_MemAlloc、NPN_MemFree、?NPN_MemFlush、NPN_ReloadPlugins、NPN_GetJavaEnv、NPN_GetJavaPeer、NPN_GetURLNotify、NPN_PostURLNotify、NPN_GetValue、NPN_SetValue、NPN_InvalidateRect、NPN_InvalidateRegion、NPN_ForceRedraw、?NPN_GetStringIdentifier、NPN_GetStringIdentifiers、等 详细接口请参照：?????? HYPERLINK /en/Gecko_Plugin_API_Reference:Browser_Side_Plug-in_API /en/Gecko_Plugin_API_Reference:Browser_Side_Plug-in_API???和 HYPERLINK /en/Gecko_Plugin_API_Reference/Scripting_plugins /en/Gecko_Plugin_API_Reference/Scripting_plugins 4)重要函数结构说明 ①NPError NPP_New(NPMIMEType pluginType,?????? //插件提供给浏览器的识别信息，浏览器解析HTML时根据该表示来调用和加载插件 NPP instance, //插件实例 uint16 mode, ?//插件