使用指南
Cocos 组件 / 瓦片地图 / TiledTile节点
Cocos 组件 / 瓦片地图 / TiledTile 节点手册，包含 6 个节点的用途、引脚、使用场景和注意事项。
16
学习目标
访问 Cocos Creator 组件的属性、方法和事件，把引擎能力转成可视化工作流。
覆盖范围
- 节点数量：6
- 分类路径：Cocos 组件 / 瓦片地图 / TiledTile
典型使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
通用注意事项
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
- 部分组件能力受 Cocos Creator 版本限制，页面会标出版本字段。
节点索引
| 节点 | 节点 ID | 输入/输出 | 执行方式 |
|---|---|---|---|
| 获取横向坐标 | tiledTileGetX | 1 / 1 | 立即继续 |
| 获取瓦片GID | tiledTileGetGid | 1 / 1 | 立即继续 |
| 获取纵向坐标 | tiledTileGetY | 1 / 1 | 立即继续 |
| 设置横向坐标 | tiledTileSetX | 3 / 2 | 立即继续 |
| 设置瓦片GID | tiledTileSetGid | 3 / 2 | 立即继续 |
| 设置纵向坐标 | tiledTileSetY | 3 / 2 | 立即继续 |
获取横向坐标
读取目标地图块当前所在列坐标（x）。 注意：单位是地图块（tile），不是像素坐标。坐标从 0 开始，表示该格在图层中的列号。 适合用于判断、保存或作为动态计算偏移的基准。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | tiledTileGetX |
| 分类 | Cocos 组件 |
| 二级分类 | 瓦片地图 |
| 分组 | TiledTile |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
tiledTile | 瓦片块 | 数据 | cc.Component / TiledTile | TiledTile 瓦片块组件 连接一个已挂载的 TiledTile 组件引用。 TiledTile 用于精确控制某一个地图块：可读写该格的坐标与 GID。 请先通过 获取组件从节点上获取 TiledTile 组件。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
x | X坐标 | 数据 | number | 横向坐标 地图块在当前图层中的列号，单位为 tile。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取瓦片GID
读取目标地图块当前的图块编号（GID）。 GID 是瓦片地图中每个图块的唯一标识，可区分不同的地形、装饰和功能块。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | tiledTileGetGid |
| 分类 | Cocos 组件 |
| 二级分类 | 瓦片地图 |
| 分组 | TiledTile |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
tiledTile | 瓦片块 | 数据 | cc.Component / TiledTile | TiledTile 瓦片块组件 连接一个已挂载的 TiledTile 组件引用。 TiledTile 用于精确控制某一个地图块：可读写该格的坐标与 GID。 请先通过 获取组件从节点上获取 TiledTile 组件。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
gid | GID | 数据 | number | 当前格子的图块编号 瓦片地图中该格的 GID 标识。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取纵向坐标
读取目标地图块当前所在行坐标（y）。 注意：单位是地图块（tile），不是像素坐标。坐标从 0 开始，表示该格在图层中的行号。 适合用于判断、保存或作为动态计算偏移的基准。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | tiledTileGetY |
| 分类 | Cocos 组件 |
| 二级分类 | 瓦片地图 |
| 分组 | TiledTile |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
tiledTile | 瓦片块 | 数据 | cc.Component / TiledTile | TiledTile 瓦片块组件 连接一个已挂载的 TiledTile 组件引用。 TiledTile 用于精确控制某一个地图块：可读写该格的坐标与 GID。 请先通过 获取组件从节点上获取 TiledTile 组件。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
y | Y坐标 | 数据 | number | 纵向坐标 地图块在当前图层中的行号，单位为 tile。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置横向坐标
修改目标地图块所在的列坐标（x），参数单位是地图块，不是像素。 坐标从 0 开始，表示该格在图层中的列号。无效的越界值会被引擎拒绝。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | tiledTileSetX |
| 分类 | Cocos 组件 |
| 二级分类 | 瓦片地图 |
| 分组 | TiledTile |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
tiledTile | 瓦片块 | 数据 | cc.Component / TiledTile | TiledTile 瓦片块组件 连接一个已挂载的 TiledTile 组件引用。 TiledTile 用于精确控制某一个地图块：可读写该格的坐标与 GID。 请先通过 获取组件从节点上获取 TiledTile 组件。 | - | 必填 |
x | X坐标 | 数据 | number | 横向坐标 要设置的地图块列号，单位为 tile。 | 输入框 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
tiledTile | 瓦片块 | 数据 | cc.Component / TiledTile | TiledTile（透传） 把当前操作的 TiledTile 组件原样传出，便于将多个节点串联在一起。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置瓦片GID
设置目标地图块的图块编号（GID），切换该格显示的图块样式。 注意：两条限制
- 只能设置为当前地图资产中已有 tile 的 GID，无法引用其他地图或空 GID。
- 不能把它当成普通 Sprite 那样替换任意图片：TiledTile 只是在地图内切换已有 tile，不改变资产。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | tiledTileSetGid |
| 分类 | Cocos 组件 |
| 二级分类 | 瓦片地图 |
| 分组 | TiledTile |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
tiledTile | 瓦片块 | 数据 | cc.Component / TiledTile | TiledTile 瓦片块组件 连接一个已挂载的 TiledTile 组件引用。 TiledTile 用于精确控制某一个地图块：可读写该格的坐标与 GID。 请先通过 获取组件从节点上获取 TiledTile 组件。 | - | 必填 |
gid | GID | 数据 | number | 目标图块编号 要设置的 GID，只能使用当前地图中已有的 tile GID。 | 输入框 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
tiledTile | 瓦片块 | 数据 | cc.Component / TiledTile | TiledTile（透传） 把当前操作的 TiledTile 组件原样传出，便于将多个节点串联在一起。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置纵向坐标
修改目标地图块所在的行坐标（y），参数单位是地图块，不是像素。 坐标从 0 开始，表示该格在图层中的行号。无效的越界值会被引擎拒绝。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | tiledTileSetY |
| 分类 | Cocos 组件 |
| 二级分类 | 瓦片地图 |
| 分组 | TiledTile |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
tiledTile | 瓦片块 | 数据 | cc.Component / TiledTile | TiledTile 瓦片块组件 连接一个已挂载的 TiledTile 组件引用。 TiledTile 用于精确控制某一个地图块：可读写该格的坐标与 GID。 请先通过 获取组件从节点上获取 TiledTile 组件。 | - | 必填 |
y | Y坐标 | 数据 | number | 纵向坐标 要设置的地图块行号，单位为 tile。 | 输入框 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
tiledTile | 瓦片块 | 数据 | cc.Component / TiledTile | TiledTile（透传） 把当前操作的 TiledTile 组件原样传出，便于将多个节点串联在一起。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。