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);
    }
});

郑重声明:本站内容如果来自互联网及其他传播媒体,其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。