Android浏览器插件开发（三）——ANPInterface的介绍

 

今天讲一下ANPInterface。

大概是为了弥补NPAPI在Android上的不足，Google在Android的浏览器上实现了ANPInterface这么一个东西。说白了这玩意就是一系列的操作接口（函数），提供了一些NPAPI没有的东西。插件可以在初始化的时候获取这些ANPXXXInterface，并在运行过程中使用。

关于这些接口的使用，大家可以看一看作为例子的BrowserPlugin是怎么做的，

main.cpp中，声明了一些ANPInterface的全局变量：

ANPAudioTrackInterfaceV0 gSoundI; ANPBitmapInterfaceV0 gBitmapI; ANPCanvasInterfaceV0 gCanvasI; ANPEventInterfaceV0 gEventI; ANPLogInterfaceV0 gLogI; ANPPaintInterfaceV0 gPaintI; ANPPathInterfaceV0 gPathI; ANPSurfaceInterfaceV0 gSurfaceI; ANPSystemInterfaceV0 gSystemI; ANPTypefaceInterfaceV0 gTypefaceI; ANPWindowInterfaceV0 gWindowI;

 

下面则是中NP_Initialize里面的一段：

static const struct { NPNVariable v; uint32_t size; ANPInterface* i; } gPairs[] = { { kAudioTrackInterfaceV0_ANPGetValue, sizeof(gSoundI), &gSoundI }, { kBitmapInterfaceV0_ANPGetValue, sizeof(gBitmapI), &gBitmapI }, { kCanvasInterfaceV0_ANPGetValue, sizeof(gCanvasI), &gCanvasI }, { kEventInterfaceV0_ANPGetValue, sizeof(gEventI), &gEventI }, { kLogInterfaceV0_ANPGetValue, sizeof(gLogI), &gLogI }, { kPaintInterfaceV0_ANPGetValue, sizeof(gPaintI), &gPaintI }, { kPathInterfaceV0_ANPGetValue, sizeof(gPathI), &gPathI }, { kSurfaceInterfaceV0_ANPGetValue, sizeof(gSurfaceI), &gSurfaceI }, { kSystemInterfaceV0_ANPGetValue, sizeof(gSystemI), &gSystemI }, { kTypefaceInterfaceV0_ANPGetValue, sizeof(gTypefaceI), &gTypefaceI }, { kWindowInterfaceV0_ANPGetValue, sizeof(gWindowI), &gWindowI }, }; for (size_t i = 0; i < ARRAY_COUNT(gPairs); i++) { gPairs[i].i->inSize = gPairs[i].size; NPError err = browser->getvalue(NULL, gPairs[i].v, gPairs[i].i); if (err) { return err; } }

 

该段的目的就是通过浏览器NPN接口里面的getvalue获取一系列ANPInterface。由于定义为了全局变量，所以这些接口可以在随时随地使用，就像这样：

gLogI.log(kDebug_ANPLogType, "------ %p DrawingModel is %d", instance, model);

 

 

下面就我所知道的情况说说这些接口都提供了哪些操作。
ANPAudioTrackInterface      这是一套音频接口，提供了播放音轨的功能
ANPBitmapInterface          只有一个函数getPixelPacking，依照给定的格式设置PixelPacking的参数值
ANPCanvasInterface          提供了一系列ANPCanvas绘图操作，其实就是把skia的Skcanvas相关接口作了一个包装
ANPEventInterface           提供了一个postEvent函数，插件可以用来向自己发送自定义的消息（ANPEvent）。
ANPLogInterface             提供了logcat的输出
ANPPaintInterface           包装了skia的SkPaint的相关接口，如果要用ANPCanvas画图，那就可能需要用这些接口来设置ANPPaint参数
ANPMatrixInterface          提供了ANPMatrix(SkMatrix)的一些操作接口，用ANPCanvas画图时可能会用到
ANPPathInterface            提供了ANPPath(SkPath)的一些操作接口，用ANPCanvas画图时可能会用到
ANPSurfaceInterface         提供了从SurfaceView中获取画布ANPBitmap的接口lock，以及提交绘图结果的接口unlock
ANPSystemInterface          getApplicationDataDirectory可以获取一个叫做PluginSharedDataDirectory的地址，具体我也没试过；2.2中新增了一个接口loadJavaClass，用于获取Java Class的实例，这个主要是用在加载过程中View的实例化。
ANPTypefaceInterface        这个我不是太清楚，似乎又是skia中一些功能的封装，大概和字体有关
ANPWindowInterface          一些窗口操作的接口，包括显示软键盘、全屏控制等等

 

 

具体定义可以看external/webkit/WebKit/android/plugins下的相关文件
使用方法可以参考development/samples/BrowserPlugin这个例子。

可以看出，其实ANPInterface提供的接口，其实现大多来自webkit以外的一些底层库。或许有人会问，这和直接连接这些库有什么区别？其实从结果上看，这两种方法都是殊途同归的，不过ANPInterface更多地体现为一种包装，就算底层库有了变动，只要ANPInterface不变，插件的代码就不需要修改。例如从Android 2.1到2.2，surfaceflinger有了较大的变化，但是ANPSurfaceInterface没有改变，因此插件也就不需要对这部分作什么修改。不过实际使用过程中，还是根据自己的需要去选择用ANPInterface还是直接连接外部库吧，毕竟ANPInterface提供的接口还是很有限的。