Cocos2d-x——CocosBuilder官方帮助文档翻译1 使用自定义类

原创：请注明转载！

在Cocos2d-x中使用CocosBuilder

 

使用自定义类

CocosBuilder的使用方法是通过自定义类。在CocosBuilder中选中一个对象并在属性栏中输入自定义类的类名就可以了。记住你的自定义类必须是你选中对象的一个子类（如CCLayer，CCNode等等）

当加载ccbi文件时，你需要定义两个自定义类（也可以是一个）。自定义的Loader类继承自cocos2d::extension::CCLayerLoader。

自定义的Layer类继承自
cocos2d::extension::CCBSelectorResolver
cocos2d::extension::CCBMemberVariableAssigner
cocos2d::extension::CCNodeLoaderListener

在你的自定义Loader类中你需要加入初始化代码：

public:     CCB_STATIC_NEW_AUTORELEASE_OBJECT_METHOD(CustomLayerLoaderClass, loader);     CCB_VIRTUAL_NEW_AUTORELEASE_CREATECCNODE_METHOD(CustomLayerClass));

使用Loader类的loader方法，CCBReader可以初始化你的自定义Layer类。

 

 

请注意CCBReader不会使用任何自定义的init方法。如果要使用自定义的init方法，你可以在自定义Layer类的构造函数中调用。

 

关联成员变量

在ccbi中引用的对象可以在文件被加载时关联为成员变量。这些成员变量可以定义在文档的根节点中，在这种情况下它必须分配一个自定义类。

 

关联成员变量很简单，只要在头文件中声明它们就可以了。

如果要初始化成员变量，你可以在自定义Layer类中重载onAssignCCBMemberVariable方法并输入代码:

CCB_MEMBERVARIABLEASSIGNER_GLUE(this, "sprtBurst", CCSprite *, this->mSprtBurst);

sprtBurst是在CocosBuilder中定义的属性名。

在CocosBuilder中选择对象，在Code Connections面板下把Don't assign变为Doc root var或者Owner var。然后在右边的文本框中输入成员变量的名字。

 

添加CCMenuItemImage的回调函数

为CCMenuItemImage添加一个点击事件的回调函数很简单，在CocosBuilder中选中CCMenuItemImage，在Selector右边的文本框中输入方法的名称即可，并设置target为Document root或者Owner。

 

回调函数将把CCMenuItemImage作为它的唯一参数（参数类型是id，名称一般是sender）。或者你也可以忽略这个参数。

在你的自定义类中，重载onResolveCCBCCMenuItemSelector方法并添加如下代码：

CCB_SELECTORRESOLVER_CCMENUITEM_GLUE(this, "pressedA:", MenuTestLayer::onMenuItemAClicked);

 

在这个方法中，MenuTestLayer是你的自定义类名。

然后在你的cpp文件中，可以编写回调方法

void MenuTestLayer::onMenuItemAClicked(cocos2d::CCObject *pSender) {   }

 

 

添加CCControl的回调函数

为CCControl添加一个回调方法和CCMenuItemImage基本相同，只需要加一些额外的东西。

 

首先勾选事件类型，CCControlButton一般的事件都是Up inside。Target右边的下拉菜单选择Document root或者Owner，然后输入回调方法名。这个回调方法可以有两个参数，sender和事件类型，事件类型被定义在CCControl.h中。

在自定义类中，重载onResolveCCBCCControlSelector方法并加入如下代码：

CCB_SELECTORRESOLVER_CCCONTROL_GLUE(this, "pressedMenus:", MenuTestLayer::onPressedMenus);

 

在这个方法中，MenuTestLayer是你的自定义类名。

然后在你的cpp文件中，可以编写回调方法

void HelloCocosBuilderLayer::onMenuTestClicked(CCObject * pSender, cocos2d::extension::CCControlEvent pCCControlEvent) { }

 

 

加载ccb文件的选项

在加载CocosBuilder的文件前，CocosBuilder文档或者ccb文件需要以一种压缩的二进制格式发布——ccbi格式，一旦被发布，只要一行代码就可以简单地把它们加载到你的程序中。添加CCBReader.h 和 CCBReader.m文件到你的Cocos2D项目中（Cocos2d-x不用添加这些文件），然后调用nodeGraphFromFile方法，如下所示：

CCBReader *ccbReader = new cocos2d::extension::CCBReader(ccNodeLoaderLibrary); CCNode* myNode = ccbReader->readNodeGraphFromFile("MyNodeGraph.ccbi");

 

ccNodeLoaderLibrary的初始化有两种方法：

如果你使用的是自定义类，那么：

CCNodeLoaderLibrary * ccNodeLoaderLibrary = CCNodeLoaderLibrary::newDefaultCCNodeLoaderLibrary(); ccNodeLoaderLibrary->registerCCNodeLoader("HelloCocosBuilderLayer", HelloCocosBuilderLayerLoader::loader());

在这种情况下，HelloCocosBuilderLayer是在CocosBuilder中指定的自定义类名。

 

如果没有使用自定义类，你可以初始化一个默认的NodeLoader

CCNodeLoaderLibrary * ccNodeLoaderLibrary = CCNodeLoaderLibrary::newDefaultCCNodeLoaderLibrary();

 

根据ccbi文件中根节点的对象类型你需要对返回值做一下强制类型转换。比如，如果你加载的是一个CCParticleSystem，那么你需要如下代码：

CCParticleSystem* myParticles = (CCParticleSystem*) ccbReader->readNodeGraphFromFile("MyParticleSystem.ccbi");

 

为了方便起见，CCBReader还可以把你的节点图打包在一个场景中，然后调用sceneWithNodeGraphFromFile方法：

CCScene* myScene = ccbReader->sceneWithNodeGraphFromFile("MyScene.ccbi");

 

 

传递Owner变量

有时你可能需要访问另一个对象中的成员变量或者回调函数，而不是访问根节点中的变量和函数。这样的话，你就需要给CCBReader传递一个Owner参数。记住在CocosBuilder中声明变量或者回调函数的时候Target选择owner选项。然后调用CCBReader类的nodeGraphFromFile(file, owner)方法或者sceneWithNodeGraphFromFile(file, owner)方法来加载你的文件。

 

HelloCocosBuilderLayer *pOwner = new HelloCocosBuilderLayer(); CCNode* myNode = ccbReader->readNodeGraphFromFile("MyNodeGraph.ccbi", pOwner);

 

 

访问子ccb文件中的变量和回调函数

如果你使用了子ccb文件，并且指定root node作为目标，那么owner target就是你要传给CCBReader的对象。

 

示例

请参看HelloCocosBuilderLayer.h, HelloCocosBuilderLayer.cpp，还有cocos2d-x官方包下面的TestCPP项目中的ExtensionsTest示例。

 

设置缩放和设计尺寸

基于CocosBuilder的cocos2d-x项目，在AppDelegate类中对游戏尺寸的适配进行了设置，它会自动地从相应的目录中加载相应的资源文件。它的原理是基于设备屏幕的大小。你同样需要对缩放系数和设计分辨率这两个参数进行设置。

竖屏模式下，在AppDelegate.cpp的AppDelegate::applicationDidFinishLaunching方法中加入代码：

CCSize designSize = CCSizeMake(320, 480); CCSize resourceSize = CCSizeMake(320, 480); CCSize screenSize = CCEGLView::sharedOpenGLView()->getFrameSize();   std::vector<std::string> searchPaths; std::vector<std::string> resDirOrders;   TargetPlatform platform = CCApplication::sharedApplication()->getTargetPlatform(); if (platform == kTargetIphone || platform == kTargetIpad) {     searchPaths.push_back("Published-iOS"); // Resources/Published-iOS     CCFileUtils::sharedFileUtils()->setSearchPaths(searchPaths);       if (screenSize.height > 768)     {         resourceSize = CCSizeMake(1536, 2048);         resDirOrders.push_back("resources-ipadhd");     }     else if (screenSize.height > 640)     {         resourceSize = CCSizeMake(768, 1536);         resDirOrders.push_back("resources-ipad");     }else if (screenSize.height > 480)     {         resourceSize = CCSizeMake(640, 960);         resDirOrders.push_back("resources-iphonehd");     }     else     {         resDirOrders.push_back("resources-iphone");     }       CCFileUtils::sharedFileUtils()->setSearchResolutionsOrder(resDirOrders); } else if (platform == kTargetAndroid || platform == kTargetWindows) {       if (screenSize.height > 960)     {         resourceSize = CCSizeMake(640, 960);         resDirOrders.push_back("resources-large");     }     else if (screenSize.height > 480)     {         resourceSize = CCSizeMake(480, 720);         resDirOrders.push_back("resources-medium");     }     else     {         resourceSize = CCSizeMake(320, 568);         resDirOrders.push_back("resources-small");     }       CCFileUtils::sharedFileUtils()->setSearchResolutionsOrder(resDirOrders); }   pDirector->setContentScaleFactor(resourceSize.width/designSize.width);   CCEGLView::sharedOpenGLView()->setDesignResolutionSize(designSize.width, designSize.height, kResolutionShowAll);

 

如果是横屏的模式，你只需要把分辨率宽高的顺序调整一下就好了。比如(320, 480)变为(480,320)，(640, 960)变为(960, 640)等等。