TiledMap 组件参考

    点击 属性检查器 下方的 添加组件 -> Components -> TiledMap 按钮，即可添加 TiledMap 组件到节点上。

    TiledMap 组件参考 - 图2

    TiledMap 的脚本接口请参考 TiledMap API。

    • 在 TiledMap 组件中添加了 Tmx Asset 属性后，会在节点中自动添加与地图中的 Layer 对应的节点（如下图中的 floor、barrier 和 players 节点）。这些节点都添加了 TiledLayer 组件。请勿删除这些 Layer 节点中的 TiledLayer 组件。

    • TiledMap 组件不支持 mapLoaded 回调，在 函数中可正常使用 TiledMap 组件。

    TiledLayer 组件会将添加到地图层的节点坐标转化为地图块行列坐标。当按行列顺序渲染地图层中的地图块时，如果该地图块的行列中存在节点，那么将会中断渲染地图块转而渲染节点。当地图块中的节点渲染完毕后，会继续渲染地图块。以此实现节点与地图层相互遮挡关系。

    下面通过一个范例来介绍 TiledLayer 如何与节点相互遮挡。

    1. 在场景中新建一个节点并添加 TiledMap 组件，设置好 TiledMap 组件属性后会自动生成带有 TiledLayer 组件的节点（即地图层）。

    2. 在 资源管理器 中新建一个 TypeScript 脚本，编写组件脚本。脚本代码如下：

    3. 将脚本组件挂载到 Canvas 节点上，即将脚本拖拽到 Canvas 节点的 属性检查器 中。再将 层级管理器 中自动生成的带有 TiledLayer 组件的节点以及 资源管理器 中的预制资源拖拽至脚本组件对应的属性框中，然后保存场景。

    4. 点击编辑器上方的预览按钮，即可看到节点与地图层相互遮挡的效果。关于代码可参考 ShieldNode（ | Gitee）范例。

    若想移除地图层中的节点，调用 TiledLayer 的 removeUserNode 方法即可。