在本篇博客中,我们将通过一个在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);
}
});