COCOS2D-JS入门-官网template源码解析

首先介绍几个概念:

导演:

  导演 (Director)是Cocos2d-JS引擎抽象的一个对象,Director是整个Cocos2d-JS引擎的核心,是整个游戏的导航仪,游戏中的一些常用操作就是由Director来控制的,比如OpenGL ES的初始化,场景的转换,游戏暂停继续的控制,世界坐标和GL坐标之间的切换,对节点(游戏元素)的控制等,还有一些游戏数据的保存调用,屏幕尺寸的获取等都要由Director类来管理控制的。

场景:

  场景(Scene)是Cocos2d-JS引擎抽象的一个对象,用Cocos2d-JS制作游戏就如同拍电影,事实上所有东西都必须放置到一个场景容器中才能最终被显示出来。游戏中我们通常需要构建不同的场景(至少一个),游戏里关卡、界面的切换其实就是一个一个场景的切换,就像在电影中变换舞台或场地一样。

层:

  层(Layer)通常包含的是直接在屏幕上呈现的内容,并且可以接受用户的输入事件,包括触摸,加速度计和键盘输入等。每个游戏场景都可以有多个层,每一层都有各自负责的任务,比如专门负责背景显示的层,或显示敌人的层,或UI控件的层等等。一个场景至少有一个层(Layer)作为孩子节点。

了解了cocos游戏是由在以上三种概念的基础上建立后,我们再看源码:

首先看project.json:

我这里因为引入的是合并压缩后的cocos文件,所以把不相干的去掉了,功能如下:

COCOS2D-JS入门-官网template源码解析

这个文件没什么好说的,就是一些配置,没有功能控制类的代码,还有加载loading.js主要是在游戏资源加载完成之前显示loading的js库我们,所有主要的文件只有:main.js,resource.js,myApp.js

我们先看resource.js文件,从名字看,顾名思义是加载资源的列表,没有控制代码:

COCOS2D-JS入门-官网template源码解析

之后是main.js:

 cc.game.onStart = function(){
/**
* 判断资源是否加载完毕
* 这里的cc.sys.isNative判断如果只是写web端游戏,其实可以去掉,看API说的是判断时候是Native应用
*/
if(!cc.sys.isNative && document.getElementById("cocosLoading")) // del: !cc.sys.isNative &&
document.body.removeChild(document.getElementById("cocosLoading")); var designSize = cc.size(480, 800); //辅助功能,创建一个尺寸
var screenSize = cc.view.getFrameSize(); //获取视图的大小,即画布的尺寸 /**
* 判断是PC设备还是移动设备(这里通过视图尺寸判断)
*/
if(!cc.sys.isNative && screenSize.height < 800){ // del: !cc.sys.isNative &&
designSize = cc.size(320, 480);
/**
* 此属性通过官方API没有找到,可能是还没有更新
* 通过查看源码可以看出cc.loader返回一个对象,此对象带有一个resPath属性,这个属性即设置资源的加载配置目录
* @type {string}
*/
cc.loader.resPath = "res/Normal";
}else{
cc.loader.resPath = "res/HD";
}
/**
*cc.view.setDesignResolutionSize(width, height, resolutionPolicy) 主要用途为设置设计视图点大小的分辨率策略
* width 设计分辨率宽度
* height 设计分辨率高度
* resolutionPolicy 分辨率策略
*分辨率策略包括:
*0 ResolutionExactFit 通过拉伸适配填充屏幕:如果设计分辨率的宽高比与屏幕分辨率的宽高比不相同,那么你的游戏视图将被拉伸
*1 ResolutionNoBorder 全屏无黑边:如果设计分辨率的宽高比与屏幕分辨率的宽高比不相同,那么你的游戏视图的两个区域会被裁剪
*2 ResolutionShowAll 全屏带黑边框:如果设计分辨率的宽高比与屏幕分辨率的宽高比不相同,那么将显示两个黑边框
*3 ResolutionFixedHeight 按内容和屏幕的高度比,缩放内容的宽高
*4 ResolutionFixedWidth 按内容和屏幕的宽度比,缩放内容的宽高
*5 cc.ResolutionPolicy [仅限于Web功能]自定义分辨率策略,通过cc.ResolutionPolicy构建
*
* 通过源码可知cc.ResolutionPolicy所有常量属性代表数为下:
* cc.ResolutionPolicy.EXACT_FIT = 0;
* cc.ResolutionPolicy.NO_BORDER = 1;
* cc.ResolutionPolicy.SHOW_ALL = 2;
* cc.ResolutionPolicy.FIXED_HEIGHT = 3;
* cc.ResolutionPolicy.FIXED_WIDTH = 4;
* cc.ResolutionPolicy.UNKNOWN = 5;
*/
cc.view.setDesignResolutionSize(designSize.width, designSize.height,cc.ResolutionPolicy.SHOW_ALL);
/**
* cc.LoaderScene.preload(resources, cb, target)
* 加载资源文件,当所有资源都加载完毕后会调用target的 call function函数
*/
cc.LoaderScene.preload(g_resources, function () {
/**
* cc.director.runScene(scene)
* 运行一个场景。替换一个新的正在运行的场景或者输入第一个需要显示的场景。
* 这里我们new一个新的场景
*/
cc.director.runScene(new MyScene());
}, this);
};
/**
* cc.game.run()
* 运行游戏
*/
cc.game.run();

这里面setDesignResolutionSize()函数的第三个参数的6个效果如下:

COCOS2D-JS入门-官网template源码解析COCOS2D-JS入门-官网template源码解析COCOS2D-JS入门-官网template源码解析

COCOS2D-JS入门-官网template源码解析COCOS2D-JS入门-官网template源码解析COCOS2D-JS入门-官网template源码解析

还有一个地方要说的是cc.loader.resPath设置的就是resource.js里面加载资源的相对路径设置。

而第58行new的MyScene()对象就是接下来要说的内容:

myApp.js:

 var MyLayer = cc.Layer.extend({
helloLabel:null,
sprite:null, init:function () { /**
* 首先执行this._super()调用父类(cc.layer)原有的init
*/
this._super(); /**
* cc.director.getWinSize()
* 返回画布视图大小
* @type {*|cc.Size}
*/
var size = cc.director.getWinSize(); /**
* 添加一个图片菜单项
* cc.MenuItemImage(普通状态时的图像, 选中状态时的图像, 不可用状态时的图像, 回调函数, target)
* 此方法返回一个cc.menu对象
* 尽量将所有状态的图像都控制在同一个尺寸大小
*/
var closeItem = new cc.MenuItemImage(
s_CloseNormal,
s_CloseSelected,
function () {
cc.log("close");
},this);
/**
* 设置图片菜单项的描点为中心点
* 设置锚点,用百分比表示.
* 锚点是所有的转换和定位操作的基点.
* 它就像节点附加到其父节点的大头针.
* 锚点是格式化(normalized)点,就像百分比一样.。(0,0)表示左下角,(1,1)表示右上角.
* 但是你可以使用比(1,1)更大的值或者比(0,0)更小的值.
* 默认的锚点是(0.5,0.5),因此它开始于节点的中心位置
*/
closeItem.setAnchorPoint(0.5, 0.5); /**
* 创建一个菜单对象
*/
var menu = new cc.Menu(closeItem);
/**
* 设置原点(0,0)为左下角.即菜单对象所有子元素对应的的原点为左下角
*/
menu.setPosition(0, 0);
/**
* 把图像菜单项对象添加到菜单对象中,层级设置为1
*/
this.addChild(menu, 1);
/**
* 设置按钮显示在视图中的最右下角
*/
closeItem.setPosition(size.width - 20, 20); /**
* 添加标签
* cc.LabelTTF(text, fontName, fontSize, dimensions, hAlignment, vAlignment)
* cc.LabelTTF是cc.TextureNode的子类,此类可以使用系统字体或者指定的ttf字体文件在游戏中显示文本。
* 所有cc.Sprite的特性都可以在cc.LabelTTF中使用。
* cc.LabelTTF对象在使用js-binding方式编译的移动设备app上运行比较缓慢,可以考虑使用cc.LabelAtlas或者cc.LabelBMFont来代替。
* 你在创建cc.LabelTTF的时候可以指定字体名称、字体对齐方式、字体尺寸和字体大小,或者使用cc.FontDefinition对象来创建。
*/
this.helloLabel = new cc.LabelTTF("Hello World", "Impact", 38);
/**
* 设置标签在视图中的位置
*/
this.helloLabel.setPosition(size.width / 2, size.height - 40);
/**
* 把此标签作为此层的子元素添加到层中,层级设置为5
*/
this.addChild(this.helloLabel, 5); /**
* 添加一个背景精灵
* 创建二维一个精灵
*/
this.sprite = new cc.Sprite(s_HelloWorld);
this.sprite.setAnchorPoint(0.5, 0.5);
this.sprite.setPosition(size.width / 2, size.height / 2);
/**
* 设置节点的缩放比例.默认的缩放比例是1.0.该函数可以同时修改X轴跟Y轴的缩放比例.
* this.sprite.getContentSize()
* 返回一个新的cc.size实例表示节点,为未进行变换之前的大小.
*
* 即这里以高度为比例因子,说明这里背景图片永远显示完整,不会被剪裁
*/
this.sprite.setScale(size.height / this.sprite.getContentSize().height);
/**
* 把此图片作为此层的子元素添加到层中,层级设置为0
*/
this.addChild(this.sprite, 0);
}
}); var MyScene = cc.Scene.extend({
onEnter:function () {
/**
* 首先执行this._super()调用父类(cc.scene)原有的onEnter
*/
this._super();
/**
* 创建一个MyLayer层对象
*/
var layer = new MyLayer();
/**
* 把新建的层对象添加到此场景中
*/
this.addChild(layer);
/**
* 执行层对象的init方法
*/
layer.init();
}
});

至此我们对于cocos的template模板就分析完了,这个只是对第一篇入门环境的补充,毕竟光搭建环境不知道运作原理还是无从下手的。此篇意在介绍和增强cocos web端的开发的总体认识,如果上面的模板代码明白所以然了,我想再通过网上的资料进行自我学习,还是可以写出一些自娱自乐的小游戏的,只要理解好cocos是面相对象的并且常常翻阅API,写个微信小游戏还是不成问题的,那么就到这了,大家努力吧,如果以后再cocos上有什么特别的见解,希望也能通过发表博文的形式来帮助更多的人入门,毕竟授人以鱼不如授人以渔,还需大家一起学习。

上一篇:js markdown chart flow


下一篇:Sublime Text各种插件使用方法