cocos2dx入门分析 hello world

打开新建的"findmistress"项目，可以看到项目文件是由多个代码文件及文件夹组成的，其中 Hello World 的代码文件直接存放于该项目文件夹中。下面我们来详细介绍一下项目的文件组成。

1."resource"

该文件夹主要用于存放游戏中需要的图片、音频和配置等资源文件。为了方便管理，可以在其中创建子文件夹。在不同平台下，对于文件路径的定义是不一致的，但实际接口大同小异。Cocos2d-x 为我们屏蔽了这些差异，其中"resource"文件夹可以默认为游戏运行时的目录。

 

还记得上一节我们运行起来的游戏吗？游戏中显示的 Cocos2d-x 标志就放在这个文件夹下面。除此之外，这个文件夹还保存了游戏左下角 FPS 的字体以及退出游戏按钮上的图片。

 

2."Classes"和“proj.win32” 文件夹

这两个文件夹用于放置游戏头文件和源代码文件。可以看到，项目模板为我们添加的三个文件分别为"main.h"、"main.cpp"和"resource.h"，它们是平台相关的程序文件，为 Windows 专有。通常情况下，程序入口与资源文件管理在不同平台下是不同的，但是 Cocos2d-x 的模板已经基本为我们处理好了这些细节，不需要对它们进行修改。

 

3."AppDelegate.h" 和 "AppDelegate.cpp" 文件

这两个文件是 Cocos2d-x 游戏的通用入口文件，类似于一般 Windows 工程中主函数所在的文件。接触过 iOS 开发的读者应 该会觉得这两个文件的名字似曾相识，其实 AppDelegate 在 iOS 工程中就是程序的入口文件，在介绍引擎历史的时候曾提到过。

 

Cocos2d-x 来源于 Cocos2d-iPhone，因此无论是代码风格还是文件结构，很多方面都沿袭了 Cocos2d-iPhone 的使用习惯。以后文章中，将详细介绍 Cocos2d-x 的代码风格与文件结构。

 

打开"AppDelegate.cpp"，我们可以看到已经自动添加的代码，这个文件实现了 AppDelegate 类。AppDelegate 控制着游戏的生命周期，除去构造函数和析构函数外，共有 3 个方法，下面我们将逐个介绍。

 

bool applicationDidFinishLaunching()。应用程序启动后将调用这个方法。默认的实现中已经包含了游戏启动后的必要准备：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22

//初始化游戏引擎控制器 Director，以便启动游戏引擎     // initialize director     auto director = Director::getInstance();     auto glview = director->getOpenGLView();     if(!glview) {         glview = GLView::create("My Game");         director->setOpenGLView(glview);     }   //启用 FPS 显示 director->setDisplayStats(true);    //设置绘制间隔 director->setAnimationInterval(1.0 / 60);        // create a scene. it's an autorelease object     auto scene = HelloWorld::createScene();       // run     director->runWithScene(scene);       return true;

 

 

这段代码首先对引擎进行必要的初始化，然后开启了 FPS 显示。FPS 即每秒帧速率，也就是屏幕每秒重绘的次数。启用了FPS 显示后，当前 FPS 会在游戏的左下角显示。通常在游戏开发阶段，我们会启用 FPS 显示，这样就可以方便地确定游戏运行是否流畅。

 

接下来是设置绘制间隔。绘制间隔指的是两次绘制的时间间隔，因此绘制间隔的倒数就是 FPS 上限。对于移动设备来说，我们通常都会将 FPS 限制在一个适当的范围内。过低的每秒重绘次数会使动画显示出卡顿的现象，而提高每秒重绘次数会导致设备运算量大幅增加，造成更高的能耗。人眼的刷新频率约为 60 次每秒，因此把 FPS 限定在 60 是一个较为合理的设置，Cocos2d-x 就把绘制间隔设置为 1/60 秒。至此，我们已经完成了引擎的初始化，接下来我们将启动引擎。

 

最后也是最关键的步骤，那就是创建 Hello World 场景，然后指派 Director 运行这个场景。对于游戏开发者而言，我们需要在此处来对我们的游戏进行其他必要的初始化，例如读取游戏设置、初始化随机数列表等。程序的最末端返回 true，表示程序已经正常初始化。

 

void applicationDidEnterBackground()。当应用程序将要进入后台时，会调用这个方法。具体来说，当用户把程序切换到后台，或手机接到电话或短信后程序被系统切换到后台时，会调用这个方法。此时，应该暂停游戏中正在播放的音乐或音效。动作激烈的游戏通常也应该在此时进行暂停操作，以便玩家暂时离开游戏时不会遭受重大损失。

 

void applicationWillEnterForeground()。该方法与 applicationDidEnterBackground()成对出现，在应用程序回到前台 时被调用。相对地，我们通常在这里继续播放刚才暂停的音乐，显示游戏暂停菜单等。

 

"HelloWorldScene.h"与"HelloWorldScene.cpp"文件。这两个文件定义了 Hello World 项目中默认的游戏场景。

 

Cocos2d 的游戏结构可以简单地概括为场景、层、精灵，而这两个文件就是 Hello World 场景的实现文件。每个游戏组件都可以添加到另一个组件中，形成层次关系，例如场景中可以包含多个层，层中可以包含多个精灵。在后续文章中，我们将详细讲解Cocos2d 游戏元素的概念，此处将不详细说明是如何创建出 Hello World 场景的。

 

HelloWorldScene 中定义了一个 HelloWorld 类，该类继承自 cocos2d::Layer，因此 HelloWorld 本身是一个层。HelloWorld 类包含一个静态函数和两个实例方法，下面我们来看其中比较重要的两个成员。

 

static cocos2d::Scene* createScene()。

在 Cocos2d 中，在层下设置一个创建场景的静态函数是一个常见的技巧。

我们为 HelloWorld层编写了 Layer 的一个子类，在子类中为层添加各种精灵或是逻辑处理代码。然而我们的 Hello World 场景十分简单，只包含了一个层，没有任何其他需要处理的问题。因此，我们除了创建 Scene 的一个子类之外，也可以直接使用静态函数来创建一个空场景，再把层置入场景之中，这样也十分便捷，示例代码如下所示：

1 2 3 4 5 6 7 8

// 'scene' is an autorelease object auto scene = Scene::create();   // 'layer' is an autorelease object auto layer = HelloWorld::create();   // add layer as a child to scene scene->addChild(layer);

 

 

在这段代码中， 首先利用 Scene::create方法创建了一个空场景， 然后利用Hello world::create方法创建一个HelloWorld层的实例，最后调用 scene 对象的 addChild 方法来把创建的层添加到场景之中。

 

这是我们第一次见到 addChild 方法，这个方法可以把一个游戏元素放置到另一个元素之中。

只有把一个游戏元素放置到其他已经呈现出来的游戏元素中，它才会呈现出来。

比如在这个例子中，我们把 HelloWorld 层置入到上面创建的空场景中，而在前面所述的 AddDelegate 中，我们已经让 Director 运行了该场景，因此 HelloWorld 层就会显示在屏幕上了。

 

bool init()。初始化 HelloWorld 类，相关代码如下：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39

//(1) 对父类进行初始化     if ( !Layer::init() )     {         return false;     }   //(2) 创建菜单并添加到层     auto closeItem = MenuItemImage::create(                                            "CloseNormal.png",                                            "CloseSelected.png",                                            CC_CALLBACK_1(HelloWorld::menuCloseCallback, this));        closeItem->setPosition(Point(origin.x + visibleSize.width - closeItem->getContentSize().width/2 ,                                 origin.y + closeItem->getContentSize().height/2));       // create menu, it's an autorelease object     auto menu = Menu::create(closeItem, NULL);     menu->setPosition(Point::ZERO);     this->addChild(menu, 1);   //(3) 创建"Hello World"标签并添加到层中     auto label = LabelTTF::create("Hello World", "Arial", 24);           // position the label on the center of the screen     label->setPosition(Point(origin.x + visibleSize.width/2,                             origin.y + visibleSize.height - label->getContentSize().height));       // add the label as a child to this layer     this->addChild(label, 1);   //(4) 创建显示“HelloWorld.png”的精灵并添加到层中     // add "HelloWorld" splash screen"     auto sprite = Sprite::create("HelloWorld.png");       // position the sprite on the center of the screen     sprite->setPosition(Point(visibleSize.width/2 + origin.x, visibleSize.height/2 + origin.y));       // add the sprite as a child to this layer     this->addChild(sprite, 0);

 

 

这段代码可以简单地划分为 4 个部分。

调用父类的 init 方法来进行最初的初始化。

创建关闭程序的菜单并添加到层中。

这里，我们遇到了 addChild(Node* child,int zOrder)，与之前遇到的 addChild 方法多出来了一个参数 zOrder，该参数指的是 child 的 z 轴顺序，也就是显示的先后顺序，其值越大，表示显示的位置就越靠前。

setPosition 方法用来设置游戏元素的位置。

 

关于菜单以及下面提到的文本标签，我们也会在后面的章节中详细介绍。

创建一个文本标签并添加到层中，显示内容"Hello World"。

用"HelloWorld.png"创建一个精灵并添加到层中。最后程序返回 true，表示初始化成功。

此时读者可能会有疑惑，为什么我们要在一个实例方法中初始化类，而不在构造函数中初始化呢？

 

在 C++中，一般习惯在构造函数中初始化类，然而由于 Cocos2d-x 的来源特殊，所以才没有采用 C++的编程风格。

关于编程风格，我们会在以后的文章中详细讨论。