Cocos2d-x Js Binding 的手动绑定实现

Cocos2d-x Js Binding 的手动绑定实现,第1张

概述A- A+ 一叶  2013 年 8 月 13 日  13条评论   279 次浏览   Cocos2d-x  cocos2d-x http://www.tairan.com/archives/4902 文章目录 JSB 手动绑定的实现步骤 怎样实现 C++ 回调 JS JSB 的内存管理 随着 Cocos2d-x 的发展,Cocos2d-html5 也日益完善,相比纯 C++ 的开发方式,它开发 A- A+ 一叶 2013 年 8 月 13 日 13条评论 279 次浏览 Cocos2d-x cocos2d-x http://www.tairan.com/archives/4902
文章目录 JSB 手动绑定的实现步骤 怎样实现 C++ 回调 JS JSB 的内存管理

随着 Cocos2d-x 的发展,Cocos2d-HTML5 也日益完善,相比纯 C++ 的开发方式,它开发效率更为高效,而另一个显而易见的好处便是 Js 端的 API 可以作为 Cocos2d-x JavaScript Bindings (JsB) 的接口封装。一套 API,两种解决方案,这让用 Js 快速开发游戏,通过 JsB 以接近原生代码的速度来运行游戏成为可能。

这里使用当前稳定版 Cocos2d-x-2.1.4,Xcode JsB 项目模板创建项目,如果是用其它 IDE ,注意配置好不同环境的依赖关系,本文的示例源码可以在【这里】看到。

JsB 手动绑定的实现步骤

要实现 C++ 到 Js 的手动绑定,首先我们需要定义一个待绑定的类,为了这里的解说简单,创建了一个非常简单的类,也只定义了些简单的方法,如下:

// Leafsoar.h 文件定义@R_502_6889@space ls {    class Leafsoar: public cocos2d::CCObject    public        staticCCScene* scene();virtualbool init        CREATE_FUNC();voID functionTest};}// Leafsoar.cpp 实现 ls::init(){ bRef =false;do         cocos2dcclog("leafsoar init ..."        bRef truewhile(0return bReffunctionTest    cocos2d"function Test"}

以上是我们定义的一个类,在ls命名空间里面,它很简单,继承自 CCObject,定义实现了functionTest方法,我们下面要做的就是将它绑定到 Js ,最终达到通过 Js 来创建对象,并且调用方法。如果不知道从何下手,那么下面是一种实现思路。

为了使代码风格统一 (这样的好处是任何人都能相对容易的读懂代码并修改之),我们将参照 Cocos2d-x 现有的 JsB 实现,如从AppDelegateapplicationDIDFinishLaunching方法开始,里面实现了 JsB 环境的初始化等 *** 作,其中我们看到类似sc->addRegisterCallback(register_all_cocos2dx);这样的代码,而我们将创建register_all_ls方法,来完成我们自有ls命名空间下需要绑定的代码。

编写Jsb_ls_auto.h文件,定义如下:

#include "JsAPI.h""JsfrIEndAPI.h""Scriptingcore.h" register_all_lsjscontext cx,JsObject obj);

完成了以上register_all_ls方法定义,它作为自定义 JsB 手动绑定函数的入口,内中实现绑定我么的命名空间,我们的类和方法等 ~ 所以Js_ls_auto.cpp的实现需要根据自己的需要实现,以下是当前的实现步骤,:

"Jsb_ls_auto.h""cocos2d.h""Leafsoar.h""cocos2d_specifics.hpp"// 定义 Js 端的类型JsClass  Jsb_LsLeafsoar_classJsObjectJsb_LsLeafsoar_prototype// 实现 ls 命名空间下的类绑定)    Jsval nsval    ns    Js_GetProperty(cx"ls"&nsvalifnsval == JsVAL_VOID        ns  Js_NewObject NulL        nsval  OBJECT_TO_JsVAL        Js_SetPropertyelse        Js_ValuetoObject nsval    obj  ns    // 实现绑定 Leafsoar 类,它的定义后文给出    Js_register_ls_Leafsoar}

为了实现思路的清晰,所以文章内容以register_all_ls为入口,一步步实现,需要什么,我们就去实现什么,看到上面绑定了命名空间(在 Js 中并没有明确的命名空间的机制,但 Js 能实现类似命名空间的效果),并调用了Js_register_ls_Leafsoar(cx,obj);方法来实现具体的绑定,下面是它的实现:

// 绑定 Leafsoar 类的实现 Js_register_ls_Leafsoarjscontext*global    // 创建一个 Js 类型的对象    Jsb_LsLeafsoar_class *)calloc1sizeofJsClass));// 类型名称为 **Leafsoar** 正式绑定到 Js 由 Js 调用的名称    Jsb_LsLeafsoar_class->@R_502_6889@ "Leafsoar"addProperty  Js_PropertyStubdelProperty getProperty setProperty  Js_StrictPropertyStubenumerate  Js_EnumerateStubresolve  Js_ResolveStubconvert  Js_ConvertStub// Leafsoar 类型的析构函数绑定finalize  Js_ls_Leafsoar_finalizeflags  JsCLASS_HAS_RESERVED_SLOTS2    JsPropertySpec propertIEs[]        {  JsOP_NulLWRAPPER// 为 Leafsoar 设定绑定函数,函数名 "functionTest",绑定函数 "Js_ls_Leafsoar_functionTest"// 后面可以添加其它函数绑定,如果需要,之后以 "Js_FS_END" 结尾JsFunctionspec funcs        Js_FN"functionTest" Js_ls_Leafsoar_functionTest JsPROP_PERMANENT | JsPROP_ENUMERATE),255)">        Js_FS_END    // 这里定义并且绑定了静态函数(static),包括方法名 "create" 和对应的绑定实现 "Js_ls_Leafsoar_create" st_funcs"create" Js_ls_Leafsoar_create// 初始化类型属性    Jsb_LsLeafsoar_prototype  Js_InitClass                                        cx                                        NulL // parent proto                                        Jsb_LsLeafsoar_class                                        Js_ls_Leafsoar_constructor// 这里绑定的是构造函数的实现,也就是用 Js new  *** 作符创建的对象                                        propertIEs                                        funcs      // 函数绑定// no static propertIEs                                        st_funcs// 静态函数绑定    JsBool found    Js_SetPropertyAttributes JsPROP_ENUMERATE  JsPROP_ReadonlyfoundTypeTest<ls> tJs_type_class_tpuint32_t typeID .s_ID    HASH_FIND_INT_Js_global_type_httypeID p(!        p malloc(Js_type_class_t        ptype  typeIDJsclass  Jsb_LsLeafsoar_classproto  Jsb_LsLeafsoar_prototypeparentProto         HASH_ADD_INT type}

写到这里,类型的绑定已经基本完成,但是可以看见,其中所用到的如Js_ls_Leafsoar_functionTestJs_ls_Leafsoar_finalizeJs_ls_Leafsoar_createJs_ls_Leafsoar_constructor并没有实现,它们是在绑定 Leafosar 类型的时候去绑定了,所以需要在调用前去实现它们,下面是它们的实现:

// Js 端 functionTest 所绑定的方法调用 argc Jsval vp ok  Js_TRUEobj     ls cobj   // 定义以获取真实类型 Js_THIS_OBJECT vpJs_proxy_tproxy  Jsb_get_Js_proxyobj// 获取 Js 绑定的实际对象 通过 proxy->ptr    cobj Leafsoar*)(? proxyptr     JsB_PRECONDITION2 cobj Js_FALSE"InvalID Native Object"argc         // 调用实际的方法        cobj        Js_SET_RVAL ok    Js_ReportError"wrong number of arguments"// Js 构造函数实现 Js_ls_Leafsoar_constructor"Js ls lsleafsoar constructor .."// 调用 C++ 构造函数        lsnewCCObject _ccobj dynamic_castcocos2d*>(cobj// 默认使用原有的内存管理方式_ccobj){            _ccobjautorelease        typeClass        HASH_FIND_INT typeClassassertJsclassprotoparentProto// 构造 Js 端对象,将 cobj 实际对象存入Js_proxy_t p  Jsb_new_proxy        Js_Add@R_502_6889@dobjectRoot"ls::Leafsoar"        "wrong number of arguments: %d,was expecting %d"// 静态函数 create 的具体实现"Js ls lsleafsoar create .."// 创建 Leafsoar 对象 ret create        Jsval Jsret            ret                 Js_get_or_create_proxy>( ret                Jsret proxy             JsVAL_NulL Jsret    Js_ReportErrorJsFreeOpfop// 析构函数实现,如果在构造函数做了什么,如开辟内存空间,那么需要在这里做些收尾工作//    cclOGINFO("Jsbindings: finalizing Js object %p (LsLeafsoar)",obj);}

通过以上的步骤,我们实现了 C++ 类 Leafosar 到 Js 端的绑定。在 Js 中我们可以通过以下调试测试:

// var ls = new ls.Leafsoar();// 或者var.// 之后调用ls();
怎样实现 C++ 回调 Js

在上文,完成了 C++ 到 Js 的手动绑定,但有时我们还需要其它一些功能,比如想在 C++ 开一个多线程以加载资源,或者一个网络异步请求,再如要实现一个 delegate 以实现接口回调,然这些都归为同一个问题,实现 C++ 到 Js 的回调。我们在 Js 端定义了一个 Leafsoar 对象,并且新实现了一个方法,等待 C++ 端的回调,如下:

// 创建一个对象// 定义回调函数 callbackcallback functioni j    log"ls.callback "+ i ();

我们想通过调用functionTest之后回调在 Js 端定义的 callback 方法。那么我们需要重新实现 C++ 端的 functionTest 方法:

 Jsb_get_native_proxythis    Jsval retval jc ScriptingcoregetInstance()->getGlobalContext//  定义参数,由两个参数    Jsval v        v[] int32_to_Jsvaljc32UINT_TO_JsVAL88// 通过 Scriptingcore 封装好的方法实现回调,可以帮助我们节省很多细节上的研究executeFunctionWithOwnerOBJECT_TO_JsVAL"callback" vretval}
JsB 的内存管理

了解 Cocos2d-x 的朋友知道,它的内存管理方式,如果对此有疑问,可以参见Cocos2d-x 内存管理浅说和深入理解 Cocos2d-x 内存管理这两篇文章,那么在 JsB 我们如何来管理内存呢?在 C++ 需要通过retainrelease来实现引用计数的管理(源码示例也给出它的绑定实现,但仅仅作为参考),在绑定 Js 时,如果不做相应处理,那么可能会出现 Js 正在运行着的代码,所绑定的实际 C++ 对象已经释放。虽然我们能通过 绑定实现 retain 和 release 方法,来实现 Js 端的此方法调用,但这显然不符合 Js 代码边的习惯,它是自动回收的,所以这里推荐始终由 SpIDerMonkey 来保持一份对象引用,以使它更像 Js 的使用方式,当 Js 垃圾回收自动执行时,在去释放 SpIDerMonkey 对对象的引用。

要做到这一点,我们需要只要修改上文的代码实现,在 构造函数,create 静态方法,实现对 C++ 类型对象的引用,在 析构绑定的析构函数中解除对其的引用以完成 C++ 到 Js 端绑定的内存管理方案。

本文出自:http://www.tairan.com/archives/4902

总结

以上是内存溢出为你收集整理的Cocos2d-x Js Binding 的手动绑定实现全部内容,希望文章能够帮你解决Cocos2d-x Js Binding 的手动绑定实现所遇到的程序开发问题。

如果觉得内存溢出网站内容还不错,欢迎将内存溢出网站推荐给程序员好友。

欢迎分享,转载请注明来源:内存溢出

原文地址:https://54852.com/web/1018821.html

(0)
打赏 微信扫一扫微信扫一扫 支付宝扫一扫支付宝扫一扫
上一篇 2022-05-23
下一篇2022-05-23

发表评论

登录后才能评论

评论列表(0条)

    保存