NPAPI插件开发详细记录:脚本化接口

scriptable接口的实现,与属性有关的函数为HasProperty、GetProperty、SetProperty。在JS中设置属性(以bar为例)用plugin.bar=barvalue;来设置,获取属性直接用plugin.bar;如果要为插件创建属性,必须要在HasProperty中返回true,在GetProperty一般调用NPN_GetProperty(mNpp,sWindowObj,name,result);即可,如果有特殊目的也可以自行编写其实现代码;设置属性用NPN_SetProperty(mNpp,sWindowObj,name,value);与method相关的函数为HasMethod和Invoke,如果要为插件创建一个method,那么必须在HasMethod中为该函数返回true,method的实现代码应在Invoke实现或者由Invoke调用。如果既是method又是property,那么在JS中既可以plugin.foo=value;和plugin.foo进行设置或获取属性值,又可以用plugin.foo();调用相应的函数功能,但是使用plugin.foo()的时候是先调用GetProperty再调用foo()方法的实现代码的。
最简单的一个例子是:
bool ScriptablePluginObject::HasMethod(NPIdentifier name){return true;}
bool ScriptablePluginObject::HasProperty(NPIdentifier name){return true;}
bool ScriptablePluginObject::GetProperty(NPIdentifier name, NPVariant *result)
{return NPN_GetProperty(mNpp,sWindowObj,name,result);}
bool ScriptablePluginObject::SetProperty(NPIdentifier name, const NPVariant *value)
{return NPN_SetProperty(mNpp,sWindowObj,name,value);}
bool ScriptablePluginObject::Invoke(NPIdentifier name, const NPVariant *args, uint32_t argCount, NPVariant *result)
{MessageBox(NULL,"functions called","msg",0);return true;}

这样在JS中用任意的字符串代替前面的foo或者bar都会正常的调用前述相关代码。有一点需要指出的是在JS中任何Object都可以设置属性如:
var t=new Object();
t.anystr=val;
alert(t.anystr);

这种方式与前面的不同点在于,这种方式只是JS内核的操作,其设置的属性在插件代码中是无法访问的,插件实现属性设置的机制的目的也就是为了能够方便的访问通过JS设置的属性吧!
要设置几个特定的属性或者方法就需要结合NPN_GetStringIdentifier来实现了。具体见例子程序。
在scriptable的插件中,在Plugin类和ScriptableObject类之间共享数据是非常必要的,使用全局变量当然是一种办法,但是这样会在一个页面中有多个插件实例时产生严重的后果。因此不提倡这样做。注意ScriptableObject的成员mNpp是getScriptObject返回的,而这个mNpp就是Plugin类中的NPP结构,而这个NPP结构的pdata指向的就是Plugin类本身( 在NPP_New中有instance->pdata = (void *)plugin;)。将mNpp->pdata强制转换为Plugin类的指针,然后就可以访问其中的公有成员了。
设置或者获取属性一般也不需要调用NPN的相关接口了,只需要在Plugin中定义一个公有成员变量,在SetProperty中Plugin* plugin=(Plugin*)mNpp->pdata;
plugin->m_bar = NPVARIANT_TO_INT32(*value);在GetProperty中使用Plugin* plugin=(Plugin*)mNpp->pdata;INT32_TO_NPVARIANT(plugin->m_bar,*result);就可以了。具体请参考相关示例代码。


写了个简单的demo。http://download.csdn.net/detail/z6482/5039075

你可能感兴趣的:(object,脚本,null)