精灵点点基础教程5 -- 编写扩展程序

摘要:虽然点点的内核功能仍然在不断的增加中,但毕竟不能一下就完善起来,所以在遇到无法实现的功能时,还是需要你自己编写扩展来实现想要的功能。  

虽然如此,不过也不要怕,因为编写一个扩展真的是一件非常简单的事情,只需根据下面的步骤一步一步操作即可,不过需要一些C和C++的功底


目录    

精灵点点简明教程1 -- 下载与安装

精灵点点简明教程2 -- 基本操作

精灵点点简明教程3 -- 录制脚本

精灵点点简明教程4 -- 编辑与调试脚本

精灵点点简明教程5 -- 编写扩展程序

精灵点点简明教程6 -- 发布脚本

精灵点点简明教程7 -- 自建窗体


 

编写扩展程序

虽然点点的内核功能仍然在不断的增加中,但毕竟不能一下就完善起来,所以在遇到无法实现的功能时,还是需要你自己编写扩展来实现想要的功能。  

虽然如此,不过也不要怕,因为编写一个扩展真的是一件非常简单的事情,只需根据下面的步骤一步一步操作即可,不过需要一些C和C++的功底。 

1. 首先我们打开精灵点点的安装根目录。 

2. 进入ExtensionSources目录,会在里面有一个名为ACExtendDemo的目录,点进去双击ACExtendDemo.sln,这是一个VS2010的示例解决方案。 

3. 打开解决方案后,打开dllmain.cpp,扩展程序的源文件都在这里面了 

下面我们将dllmain.cpp的主要内容粘帖在下面,仔细看里面的注释。

// 因为从V8引擎传过来的字符都是UTF8,而我们的工程选择的是UNICODE字符集,所以需要相互的转化函数
char* UnicodeToUTF8(const wchar_t* wp){
  // 具体内容看源代码
};
// UnicodeToUTF8的逆向
WCHAR* UTF8ToUnicode(const char* c){
  // 具体内容看源代码
};
// 将字符串解析成JSON对象
Json::Value ParseJson(WCHAR* json){
  // 具体内容看源代码
};
/**************************************************************************
方法描述:真正的导出函数,在我们的脚本里被调用的函数
参数: params 点点扩展函数的参数只有一个就是字符型的params,可以是任意的字符串
如果需要传递的参数是复杂的数据结构,可以使用JSON字符串的方式传入,在这个扩展函数
里的params就类似是这样的结构 "{a:3,b:6}"
返回值:点点扩展函数的返回值均为字符串,如果需要返回复杂的结构,可以将结构体转化
为JSON字符串返回
**************************************************************************/
extern "C" __declspec(dllexport) WCHAR* Sum(WCHAR *params){
  // 假如 params为字符串 "{a:3,b:6}"
  // 解析JSON字符串
  Json::Value p = ParseJson(params);
  // 获取a的值,此时为3
  int a = p["a"].asInt();  
  // 获取b的值,此时为6
  int b = p["b"].asInt();
  // 两数相加,c=9
  int c = a + b;
  // 将计算结果转化为字符串返回
  WCHAR *r = new WCHAR[12];
  wsprintf(r, L"%d", c);
  return r;
};
// 返回JSON字符串的情况
extern "C" __declspec(dllexport) WCHAR* GetPoint(WCHAR *params){
  return L"{\"x\":12,\"y\":8}";
};
// 直接执行操作的情况
extern "C" __declspec(dllexport) WCHAR* OpenUrl(WCHAR *params){
  WCHAR * url = params;
  ::ShellExecute(NULL, L"open", L"explorer", url, NULL, SW_SHOW);
  return L"";  
};

然后我们将此工程编译,此时会生成一个名为ACExtensionDemo.dll的文件 ,将此文件拷贝到安装目录下的Extensions里。

这样我们就可以在脚本中调用刚才写的扩展方法了,我们这里以调用extern "C" __declspec(dllexport) WCHAR* Sum(WCHAR *params)这个方法为例来说明一下。

脚本应该象这样写  

// 构造扩展方法的对象,其中函数为DLL的名字
var aed = ex("ACExtensionDemo");
// 调用Sum方法,其中第一个参数为方法名,第二个为参数,此参数会被作为params传递给DLL里的Sum方法,回想一下刚才扩展里面的SUM方法的注释。
// 此方法执行完成后ret的值为9.  
var ret = aed.call('sum','{a:3,b:6}');
// 虽然讲在DLL里方法的参数PARAMS必须为字符串,但在脚本里我们仍然可以如下面的调用方式,这种情况JSON对象会被自动转化为字符串传递给DLL的扩展方法
var ret1 = aed.call('sum',{a:3,b:6});

写一个扩展并调用,是不是非常简单。:)           

  

posted @ 2015-08-01 10:24  乔伟2024  阅读(1186)  评论(2编辑  收藏  举报