cocos_creator3-TiledMa/README.md

233 lines
7.9 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 【Cocos Creator实战教程(3)】——TiledMap(瓦片地图)组件
# 1. 前言
瓦片地图是由一张一张的正方形小图片拼接成的地图例如炸弹人QQ堂都是非常典型的瓦片游戏。瓦片地图(Tile Map) 不但生成简单并且可以灵活的用于Cocos2d-x引擎。不论你的游戏是角色扮演游戏, 平台动作游戏或仿打砖块游戏这些游戏地图可以使用开源的瓦片地图编辑器Tiled Map Editor生成并保存为TMX文件格式被Cocos2d-x支持。
# 2. 步骤
## 2.1 安装Tiled Map Editor
edit编辑->preferences参数里面可以设置语言
## 2.2 TiledMap制作
新建一张地图
![](http://www.writebug.com/myres/static/uploads/2021/10/19/2073ffdc213720b23fdd99290f63fcbc.writebug)
建立三个图层和一个对象层并将资源图块导入 (最下面的图层将显示在最下面)
![](http://www.writebug.com/myres/static/uploads/2021/10/19/f5cc925b462d0622db924349b378fb99.writebug)
![](http://www.writebug.com/myres/static/uploads/2021/10/19/55707c0c968f1f06b20b473314bf33dc.writebug)
- ground层用ground图块填充满按住鼠标左键
- barriers层用barrier图块
- stars层用star图块
最终效果如下图
![](http://www.writebug.com/myres/static/uploads/2021/10/19/d4e26d89a72cbe0c785018bade67c210.writebug)
选择players对象层在如图位置插入两个图块对象并更改名称如图
![](http://www.writebug.com/myres/static/uploads/2021/10/19/1e89caef94d4a7cba70956c96935276d.writebug)
给星星添加一个属性
![](http://www.writebug.com/myres/static/uploads/2021/10/19/57260a623ccf76401d35b45764a30d62.writebug)
保存为tmx文件和图片文件放在一起
### 2.3 Cocos Creator中使用TiledMap
- 新建一个TiledMapTest工程创建一个Game场景
- 将刚才生成的tmx文件和相关图片一起添加到工程
- 将map.tmx文件拖入层级管理器或者属性编辑器就会自动生成map节点以及其子节点(也就是图层节点)【没有对象层节点】
- 最后将player安卓小机器人图片拖入位置随意创建player节点并使其为map节点的子节点。
- 调整map和player节点的锚点都为0,0也就是左下角
- 创建map.js脚本添加到map节点
```javascript
cc.Class({
extends: cc.Component,
properties: {
},
// use this for initialization
onLoad: function () {
this.player = this.node.getChildByName('player');
this.loadMap();
cc.systemEvent.on(cc.SystemEvent.EventType.KEY_DOWN, this.onKeyDown, this);
},
onKeyDown:function(event){
var newTile = cc.p(this.playerTile.x, this.playerTile.y);
switch(event.keyCode) {
case cc.KEY.up:
newTile.y -= 1;
break;
case cc.KEY.down:
newTile.y += 1;
break;
case cc.KEY.left:
newTile.x -= 1;
break;
case cc.KEY.right:
newTile.x += 1;
break;
default:
return;
}
this.tryMoveToNewTile(newTile);
},
//加载地图文件时调用
loadMap: function () {
//初始化地图位置
this.node.setPosition(cc.visibleRect.bottomLeft);
//地图
this.tiledMap = this.node.getComponent(cc.TiledMap);
//players对象层
let players = this.tiledMap.getObjectGroup('players');
//startPoint和endPoint对象
let startPoint = players.getObject('startPoint');
let endPoint = players.getObject('endPoint');
//像素坐标
let startPos = cc.p(startPoint.offset.x, startPoint.offset.y);
let endPos = cc.p(endPoint.offset.x, endPoint.offset.y);
//障碍物图层和星星图层
this.barriers = this.tiledMap.getLayer('barriers');
this.stars = this.tiledMap.getLayer('stars');
//出生Tile和结束Tile
this.playerTile = this.startTile = this.getTilePos(startPos);
this.endTile = this.getTilePos(endPos);
//更新player位置
this.updatePlayerPos();
},
tryMoveToNewTile: function(newTile) {
let width = this.tiledMap.node.width;
let height = this.tiledMap.node.height;
if (newTile.x < 0 || newTile.x >= width) return;
if (newTile.y < 0 || newTile.y >= height) return;
if (this.barriers.getTileGIDAt(newTile)) {//GID=0,则该Tile为空
cc.log('This way is blocked!');
return false;
}
this.tryCatchStar(newTile);
this.playerTile = newTile;
this.updatePlayerPos();
if (cc.pointEqualToPoint(this.playerTile, this.endTile)) {
cc.log('succeed');
}
},
tryCatchStar: function(newTile){
let GID = this.stars.getTileGIDAt(newTile);
let prop = this.tiledMap.getPropertiesForGID(GID);
if (this.stars.getTileGIDAt(newTile)) {//GID=0,则该Tile为空
this.stars.removeTileAt(newTile);
}
},
//将像素坐标转化为瓦片坐标
getTilePos: function(posInPixel) {
let mapSize = this.node.getContentSize();
let tileSize = this.tiledMap.getTileSize();
let x = Math.floor(posInPixel.x / tileSize.width);
let y = Math.floor(posInPixel.y / tileSize.height);
return cc.p(x, y);
},
updatePlayerPos: function() {
let pos = this.barriers.getPositionAt(this.playerTile);
this.player.setPosition(pos);
},
});
```
最终如下图:
![](http://www.writebug.com/myres/static/uploads/2021/10/19/4c8af8d19a8981d167d1f9ae5365a399.writebug)
# 3. 总结
```javascript
# CC.TiledMap:
~properties:
tmxFile//地图文件
mapLoaded//地图加载是调用的函数
~function:
getMapSize()//
setMapSize()//
getTileSize()//
setTileSize()//
getLayer(name)//returns TieldLayer
getObjectGroup(name)//returns TMXObjectGroup
getPropertiesForGID(GID)//returns Object(属性字典)
# CC.TieldLayer
getPositionAt(pos)//returns Vec2(像素坐标) 参数是瓦片坐标
removeTileAt(pos)//瓦片坐标
getTileGIDAt(pos)//returns Number(全局唯一标识0为空)
getTileAt(pos)//returns _ccsg.Sprite //removeChild(sprite);
setTileGID(gidpos)//相当于在pos位置添加GID的图块原来的图块删除
getTileSize()//
setTleSize()//
getMapTileSize()
# TMXObjectGroup:
~properties:
~function:
var getObject(var objectName)//返回属性字典
# _ccsg.Sprite://cocos js 里的Sprite继承自CC.Node,而不是组件
~properties
x
y
width
height
opacity
...//节点的属性都有
~function:
var setSpriteFrame(var spriteFrameName)
var runAction(var action)
...//节点的方法都有
```
- 图块放置的位置是基于像素坐标而图块在map中的索引是基于瓦片坐标整数所以在脚本文件中要适时转变
- 对象层的对象比如我们上面做的两个player point在Cocos Creator中是不会显示的
- 对象层记录的是位置信息,图层记录的是图片信息
- .tmx文件其实保存的图块的一种映射关系所以图块文件和地图文件要始终放在一起不然可能会显示出错
- GID是图块在一个地图文件中的唯一ID图块指的是右下角的图块文件每一个图块都不相同瓦片指的指地图中的块可以是相同的图块GID为0说明该Tile的图块为空
- 当利用getPropertiesForGID(GID)之类的方法时,得到的返回值是属性字典,可以直接通过点方法得到其属性值,属性值都是字符串类型
- 当用到getTileAt(pos)时得到的返回值是Cocos2d 的Sprite而不是Cocos Creator的Sprite相关方法可以查找Cocos2d js的API需要注意的一点是Cocos2d的Sprite是继承自节点的而不是组件式所以我们可以直接这样写“mySprite.x = 100”而不是“mySprite.node.x = 100”
- 地图中同一层只能使用一张图集里的图块
注意:本教程资源部分来源于网络