Cocos2d-JS中使用CocosStudio资源——关卡选择界面

在本篇博客中，我们将通过一个在Cocos2d-JS中使用从CocosStudio导出的关卡选择界面资源的例子，来简要介绍以下内容：Button控件，Text控件，PageView控件,即翻页容器的使用。

一、CocosStudio准备

第一步：从官网下载相应的示例，LevelSelection。效果图如下：

第二步：修改其中的一些控件的名称，方便寻找获取，如：

由于官网给的例子中的控件名字有的较复杂，所以可以按照自己的想法进行修改。

第三步：发布资源。注意发布设置中应该将数据格式改为JSON格式，发布位置你可以选择Cocos Code IDE中所创建的项目的res文件夹即可，当然，也可以另选其他文件夹。具体发布设置如下图：

二、Cocos Code IDE操作

第一步：创建Cocos2d-JS项目，并将Cocos Studio发布的资源res，拷贝到项目的res文件夹下或直接发布到项目的res文件夹下。

PS:创建项目的时候，分辨率默认640 x 960就可以了，方向选择竖向。

第二步：修改project.json文件，在modules中添加cocostudio。在jsList中添加LevelSelectionScene.js和resource.js。具体代码如下：

{
  "project_type": "javascript",
  "debugMode": 1,
  "showFPS": true,
  "frameRate": 60,
  "id": "gameCanvas",
  "renderMode": 0,
  "engineDir": "frameworks/cocos2d-html5",
  "modules": [
    "cocos2d",
    "cocostudio"
  ],
  "jsList": [
    "src/resource.js",
    "src/LevelSelectionScene.js"
  ]
}

第三步：在resource.js文件中指定所需的各种资源，以备后期加载使用。具体代码如下：

var res = {
        level_selection_json:"res/LevelSelection.json"
};

var g_resources = [];
for (var i in res) {
    g_resources.push(res[i]);
}

第四步：非常非常重要的一步，你需要修改main.js文件，将其中的：cc.view.setDesignResolutionSize(960,640,cc.ResolutionPolicy.SHOW_ALL);改为cc.view.setDesignResolutionSize(640, 960, cc.ResolutionPolicy.SHOW_ALL);。

虽然，我们选择的方向是竖向，但是不知道为什么，当创建项目的时候宽高还是为960,640。而，竖向的时候宽高应该为640,960。所以，要进行相应的修改才能正常运行。如果你想看不该的效果，可以尝试一下，会有惊喜哦。

main.js的具体代码如下：

cc.game.onStart = function(){
    cc.view.adjustViewPort(true);
    cc.view.setDesignResolutionSize(640, 960, cc.ResolutionPolicy.SHOW_ALL);
    cc.view.resizeWithBrowserSize(true);
    //load resources
    cc.LoaderScene.preload(g_resources, function () {
        cc.director.runScene(new LevelSelectionScene());
    }, this);
};
cc.game.run();

三、使用CocosStudio资源

走到这里，终于到我们的重头戏（LevelSelectionScene.js）了，下面，我们将要来学习如何获取CocosStudio中导出的资源等。

第一步：加载LevelSelection界面的JSON资源分析，并获取levelSelectionScene对象。将levelSelectionScene对象加入到layer中。具体代码如下：

        //加载levelSelection界面的JSON资源分析，并获取levelSelectionScene对象。
        levelSelectionScene = ccs.load(res.level_selection_json).node;
        //将levelSelectionScene对象加入到layer中。
        this.addChild(levelSelectionScene);

第二步：从loginScene中查找相应的控件对象，包括button控件，Text控件，PageView控件等，查找方法相似。具体代码如下：

        //startButton控件
        startButton = ccui.helper.seekWidgetByName(levelSelectionScene, "Button_Enter");

        //leftButton控件，负责向左切换关卡。
        leftButton = ccui.helper.seekWidgetByName(levelSelectionScene, "Button_Left");

        //rightButton控件，负责向右切换关卡。
        rightButton = ccui.helper.seekWidgetByName(levelSelectionScene, "Button_Right");

        //pageView控件，用于展示当前所选关卡
        pageView = ccui.helper.seekWidgetByName(levelSelectionScene, "PageView_SelectPage");

        //numberText控件，用于展示当前关卡用户获得的成绩。
        numberText = ccui.helper.seekWidgetByName(levelSelectionScene, "LabelAtlas_CurrentScene");

第三步：添加事件监听和初始化处理，方法类似，具体代码如下：

        //leftButton控件，负责向左切换关卡。
        //设置按钮取消对点击事件的响应，但是按钮依旧处于正常状态。
        leftButton.setTouchEnabled(false);
        //设置按钮为禁用状态。
        leftButton.setBright(false);
        leftButton.addTouchEventListener(this.leftRightButtonTouchEvent);

        //rightButton控件，负责向右切换关卡。
        rightButton.addTouchEventListener(this.leftRightButtonTouchEvent);

        //pageView控件，用于展示当前所选关卡
        pageView.addCCSEventListener(this.pageViewStateChanged);

第四步：定义相应监听事件的具体处理信息，具体代码如下：

pageView控件触发的事件处理

    //pageView控件触发事件的处理函数
    pageViewStateChanged:function(sender,type){
        switch (type) {
        //pageView当前所在的page的index发生了变化。
        case ccui.PageView.EVENT_TURNING:
            cc.log("PageView Event Turning");
            cc.log(pageView.getCurPageIndex());
            break;
        default:
            break;
        }
    },

向左向右Button控件触发的事件处理，精华之所在。

    //leftButton和rightButton按钮点击事件的处理函数。
    leftRightButtonTouchEvent:function(sender,type){
        //根据触发事件的类型进行分情况处理，从控制台输出cc.log();
        switch (type) {
        case ccui.Widget.TOUCH_BEGAN:
            cc.log("loginButton Touch Began");
            break;
        case ccui.Widget.TOUCH_MOVED:
            cc.log("loginButton Touch Moved");
            break;
        case ccui.Widget.TOUCH_ENDED:
            cc.log("loginButton Touch Ended");
            //只有在有效点击的情况下，才进行pageView切换。
            //获取当前pageView所展示的page的index。
            var index = pageView.getCurPageIndex();
            //如果点击操作来自于“向右”按钮。
            if(sender.getName() == "Button_Right"){
                index = index + 1;
                //如果即将跳转到右边的最后一页。
                if(index == 2 ){
                    //禁用rightButton，并取消Touch事件的触发。
                    rightButton.setBright(false);
                    rightButton.setTouchEnabled(false);
                }
                //如果跳转的目标页为第1页，即当前页为第0页。
                //那么取消leftButton的禁用状态，激活Touch事件的触发。
                if(index == 1){
                    //解除禁用状态，激活Touch事件的触发。
                    leftButton.setTouchEnabled(true);
                    leftButton.setBright(true);
                }
                //跳转到目标页。
                pageView.scrollToPage(index);
            }else{
                //如果点击操作来自于“向左”按钮。
                index = index - 1;
                if(index == 0){
                    leftButton.setTouchEnabled(false);
                    leftButton.setBright(false);
                }
                if(index == 1){
                    rightButton.setTouchEnabled(true);
                    rightButton.setBright(true);
                }
                pageView.scrollToPage(index);
            }
            //提示用户所选关卡中，用户获得的成绩“星星个数”，满分是3个星星。
            var number = index + 1;
            numberText.setString(number + "/3");
            break;
        case ccui.Widget.TOUCH_CANCELED:
            cc.log("loginButton Touch Canceled");
            break;
        default:
            break;
        }
    },

代码简介：

上面的代码都有比较详细的注释，我想应该都能看懂，在这里强调几点：

初始化时：注意，我们要做的是一个关卡选择界面，初始情况下默认展示第一个关卡，那么此时常理来说是不能向左翻看关卡的。所以，向左的按钮应该处于禁用状态，当然了同时可以取消向左按钮对Touch事件的响应。这样的话，用户体验会好很多。

如若不然，你想象一下，你看到一个亮亮的按钮在诱惑你，你以为里面藏着美妙的东西，然后，你拼命地点击就是没有效果，你会多么地愤怒！

左右切换pageView时：由于你初始化时禁用了leftButton，那么在用户向右切换一页的时候，千万别忘了激活leftButton。要不然，一去不回头了。当然了，如果已经到了向右的极限，那么你此时要注意设置rightButton为禁用状态，这样才完美嘛。

有效触碰再响应：非常重要。记得在以前的教程中，我们说过，Button一共有四个事件，其中有一个TOUCH_ENDED事件，这个事件表示用户的有效点击。所以，一定不要在TOUCH_BEGAN事件中对按钮的主要功能进行处理。

你假想一下，假如你玩游戏正嗨！！！BOSS剩下一滴血，然后你不小心刮碰到退出按钮，但并没有有效点击它，但是你退出了！！！退出了！！！！

你想你有多愤怒，用户会比你更愤怒！！

四、运行效果

到这里，对于levelSelection界面的分析和使用就介绍完毕了。你可以运行一下。我的部分运行效果如下：

五、补充说明

为了方便大家学习研究，下面提供本教程项目文件的百度网盘下载链接：
链接：http://pan.baidu.com/s/1mgvHEiO 密码：03fp

LevelSelectionScene.js的完整源码如下：

var LevelSelectionLayer = cc.Layer.extend({
    levelSelectionScene:null,
    startButton:null,
    leftButton:null,
    rightButton:null,
    pageView:null,
    numberText:null,
    ctor:function(){
        this._super();
        //加载levelSelection界面的JSON资源分析，并获取levelSelectionScene对象。
        levelSelectionScene = ccs.load(res.level_selection_json).node;
        //将levelSelectionScene对象加入到layer中。
        this.addChild(levelSelectionScene);
        //从levelSelectionScene中获取控件并注册监听事件。
        this.dealWidgets();
        return true;
    },
    //从loginScene中获取控件并注册监听事件。
    dealWidgets:function(){
        //startButton控件
        startButton = ccui.helper.seekWidgetByName(levelSelectionScene, "Button_Enter");

        //leftButton控件，负责向左切换关卡。
        leftButton = ccui.helper.seekWidgetByName(levelSelectionScene, "Button_Left");
        //设置按钮取消对点击事件的响应，但是按钮依旧处于正常状态。
        leftButton.setTouchEnabled(false);
        //设置按钮为禁用状态。
        leftButton.setBright(false);
        leftButton.addTouchEventListener(this.leftRightButtonTouchEvent);

        //rightButton控件，负责向右切换关卡。
        rightButton = ccui.helper.seekWidgetByName(levelSelectionScene, "Button_Right");
        rightButton.addTouchEventListener(this.leftRightButtonTouchEvent);

        //pageView控件，用于展示当前所选关卡
        pageView = ccui.helper.seekWidgetByName(levelSelectionScene, "PageView_SelectPage");
        pageView.addCCSEventListener(this.pageViewStateChanged);
        //numberText控件，用于展示当前关卡用户获得的成绩。
        numberText = ccui.helper.seekWidgetByName(levelSelectionScene, "LabelAtlas_CurrentScene");

    },
    //pageView控件触发事件的处理函数
    pageViewStateChanged:function(sender,type){
        switch (type) {
        //pageView当前所在的page的index发生了变化。
        case ccui.PageView.EVENT_TURNING:
            cc.log("PageView Event Turning");
            cc.log(pageView.getCurPageIndex());
            break;
        default:
            break;
        }
    },
    //leftButton和rightButton按钮点击事件的处理函数。
    leftRightButtonTouchEvent:function(sender,type){
        //根据触发事件的类型进行分情况处理，从控制台输出cc.log();
        switch (type) {
        case ccui.Widget.TOUCH_BEGAN:
            cc.log("loginButton Touch Began");
            break;
        case ccui.Widget.TOUCH_MOVED:
            cc.log("loginButton Touch Moved");
            break;
        case ccui.Widget.TOUCH_ENDED:
            cc.log("loginButton Touch Ended");
            //只有在有效点击的情况下，才进行pageView切换。
            //获取当前pageView所展示的page的index。
            var index = pageView.getCurPageIndex();
            //如果点击操作来自于“向右”按钮。
            if(sender.getName() == "Button_Right"){
                index = index + 1;
                //如果即将跳转到右边的最后一页。
                if(index == 2 ){
                    //禁用rightButton，并取消Touch事件的触发。
                    rightButton.setBright(false);
                    rightButton.setTouchEnabled(false);
                }
                //如果跳转的目标页为第1页，即当前页为第0页。
                //那么取消leftButton的禁用状态，激活Touch事件的触发。
                if(index == 1){
                    //解除禁用状态，激活Touch事件的触发。
                    leftButton.setTouchEnabled(true);
                    leftButton.setBright(true);
                }
                //跳转到目标页。
                pageView.scrollToPage(index);
            }else{
                //如果点击操作来自于“向左”按钮。
                index = index - 1;
                if(index == 0){
                    leftButton.setTouchEnabled(false);
                    leftButton.setBright(false);
                }
                if(index == 1){
                    rightButton.setTouchEnabled(true);
                    rightButton.setBright(true);
                }
                pageView.scrollToPage(index);
            }
            //提示用户所选关卡中，用户获得的成绩“星星个数”，满分是3个星星。
            var number = index + 1;
            numberText.setString(number + "/3");
            break;
        case ccui.Widget.TOUCH_CANCELED:
            cc.log("loginButton Touch Canceled");
            break;
        default:
            break;
        }
    },
});

var LevelSelectionScene = cc.Scene.extend({
    onEnter:function () {
        this._super();
        var layer = new LevelSelectionLayer();
        this.addChild(layer);
    }
});