Script Graph

使用指南

资产 / 瓦片地图 / TiledMapAsset节点

资产 / 瓦片地图 / TiledMapAsset 节点手册,包含 22 个节点的用途、引脚、使用场景和注意事项。

16

学习目标

读取和验证 Cocos 资产对象,把图片、音频、材质、Prefab 等资源接入工作流逻辑。

覆盖范围

  • 节点数量:22
  • 分类路径:资产 / 瓦片地图 / TiledMapAsset

典型使用场景

  • 读取音频时长、图片尺寸、材质参数等资产信息
  • 校验加载结果是否可用
  • 创建或传递特定类型的资产实例

通用注意事项

  • 资产节点通常要求连接已加载的资产实例。
  • 父类 Asset 生命周期能力应优先使用通用资产管理节点。

节点索引

节点节点 ID输入/输出执行方式
按名称查找 TSX 文件tiledMapAssetFindTsxFileByName2 / 3立即继续
按名称查找图块精灵帧tiledMapAssetFindSpriteFrameByName2 / 4立即继续
按名称查找图片图层精灵帧tiledMapAssetFindImageLayerSpriteFrameByName2 / 3立即继续
获取 TMX 文本tiledMapAssetGetTmxXmlText1 / 1立即继续
获取 TSX 文件名数组tiledMapAssetGetTsxFileNames1 / 2立即继续
获取 TSX 文件数组tiledMapAssetGetTsxFiles1 / 2立即继续
获取所有属性tiledMapAssetGetProperties1 / 10立即继续
获取图块精灵帧尺寸数组tiledMapAssetGetSpriteFrameSizes1 / 2立即继续
获取图块精灵帧名称数组tiledMapAssetGetSpriteFrameNames1 / 2立即继续
获取图块精灵帧数组tiledMapAssetGetSpriteFrames1 / 2立即继续
获取图片图层精灵帧名称数组tiledMapAssetGetImageLayerSpriteFrameNames1 / 2立即继续
获取图片图层精灵帧数组tiledMapAssetGetImageLayerSpriteFrames1 / 2立即继续
设置 TMX 文本tiledMapAssetSetTmxXmlText3 / 2立即继续
设置 TSX 文件名数组tiledMapAssetSetTsxFileNames3 / 2立即继续
设置 TSX 文件数组tiledMapAssetSetTsxFiles3 / 2立即继续
设置所有属性tiledMapAssetSetProperties10 / 2立即继续
设置图块精灵帧尺寸数组tiledMapAssetSetSpriteFrameSizes3 / 2立即继续
设置图块精灵帧名称数组tiledMapAssetSetSpriteFrameNames3 / 2立即继续
设置图块精灵帧数组tiledMapAssetSetSpriteFrames3 / 2立即继续
设置图片图层精灵帧名称数组tiledMapAssetSetImageLayerSpriteFrameNames3 / 2立即继续
设置图片图层精灵帧数组tiledMapAssetSetImageLayerSpriteFrames3 / 2立即继续
新建地图资产tiledMapAssetCreate1 / 2立即继续

按名称查找 TSX 文件

通过 tsxFileNames 与 tsxFiles 并行数组按名称查找目标 TSX 文件。 注意:名称匹配区分大小写,且依赖资产导入时写入的名称数组。若未找到,exists 输出 false,tsxFile 和 index 输出安全默认值(null / -1)。

节点信息

字段
节点 IDtiledMapAssetFindTsxFileByName
分类资产
二级分类瓦片地图
分组TiledMapAsset
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
tiledMapAsset地图资产数据cc.Asset / TiledMapAssetTiledMapAsset 地图资产
这里需要连接一个已经加载好的 TiledMapAsset 实例。
TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。
该端口没有”选择地图资产”按钮,请先使用以下方式获取实例:
- 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。
- 获取资产:取出资产包里已加载的 TiledMapAsset。
-必填
tsxFileNameTSX 文件名数据stringTSX 文件名
要查找的 TSX 文件名称(区分大小写)。
输入框
默认值:""
必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
tsxFileTSX 文件数据cc.Asset / TextAssetTSX 文件
找到的 TSX 文件实例;未找到时为 null。
-可选
index索引数据number索引
找到的 TSX 文件在并行数组中的位置索引;未找到时为 -1。
-可选
exists是否存在数据boolean是否存在
true:成功找到指定名称的 TSX 文件;false:未找到。
-可选

使用场景

  • 读取音频时长、图片尺寸、材质参数等资产信息
  • 校验加载结果是否可用
  • 创建或传递特定类型的资产实例

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 资产节点通常要求连接已加载的资产实例。
  • 父类 Asset 生命周期能力应优先使用通用资产管理节点。

按名称查找图块精灵帧

通过 spriteFrameNames / spriteFrames / spriteFrameSizes 并行数组按名称查找图块 SpriteFrame。 注意:名称匹配区分大小写,且依赖资产导入时写入的名称数组。若未找到,exists 为 false,其他输出返回安全默认值。

节点信息

字段
节点 IDtiledMapAssetFindSpriteFrameByName
分类资产
二级分类瓦片地图
分组TiledMapAsset
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
tiledMapAsset地图资产数据cc.Asset / TiledMapAssetTiledMapAsset 地图资产
这里需要连接一个已经加载好的 TiledMapAsset 实例。
TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。
该端口没有”选择地图资产”按钮,请先使用以下方式获取实例:
- 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。
- 获取资产:取出资产包里已加载的 TiledMapAsset。
-必填
spriteFrameName图块精灵帧名称数据string图块精灵帧名称
要查找的图块名称(区分大小写)。
输入框
默认值:""
必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
spriteFrame图块精灵帧数据cc.Asset / SpriteFrame图块 SpriteFrame
找到的图块精灵帧实例;未找到时为 null。
-可选
spriteFrameSize图块尺寸数据size图块尺寸
找到的图块对应的 Size 值;未找到时为 {width:0,height:0}。
-可选
index索引数据number索引
找到的图块在并行数组中的位置索引;未找到时为 -1。
-可选
exists是否存在数据boolean是否存在
true:成功找到指定名称的图块;false:未找到。
-可选

使用场景

  • 读取音频时长、图片尺寸、材质参数等资产信息
  • 校验加载结果是否可用
  • 创建或传递特定类型的资产实例

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 资产节点通常要求连接已加载的资产实例。
  • 父类 Asset 生命周期能力应优先使用通用资产管理节点。

按名称查找图片图层精灵帧

通过 imageLayerSpriteFrameNames 与 imageLayerSpriteFrames 并行数组按名称查找图片图层 SpriteFrame。 注意:名称匹配区分大小写,且依赖资产导入时写入的名称数组。若未找到,exists 为 false,其他输出返回安全默认值。

节点信息

字段
节点 IDtiledMapAssetFindImageLayerSpriteFrameByName
分类资产
二级分类瓦片地图
分组TiledMapAsset
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
tiledMapAsset地图资产数据cc.Asset / TiledMapAssetTiledMapAsset 地图资产
这里需要连接一个已经加载好的 TiledMapAsset 实例。
TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。
该端口没有”选择地图资产”按钮,请先使用以下方式获取实例:
- 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。
- 获取资产:取出资产包里已加载的 TiledMapAsset。
-必填
imageLayerSpriteFrameName图片图层精灵帧名称数据string图片图层名称
要查找的图片图层名称(区分大小写)。
输入框
默认值:""
必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
spriteFrame图片图层精灵帧数据cc.Asset / SpriteFrame图片图层 SpriteFrame
找到的图片图层精灵帧实例;未找到时为 null。
-可选
index索引数据number索引
找到的图片图层在并行数组中的位置索引;未找到时为 -1。
-可选
exists是否存在数据boolean是否存在
true:成功找到指定名称的图片图层;false:未找到。
-可选

使用场景

  • 读取音频时长、图片尺寸、材质参数等资产信息
  • 校验加载结果是否可用
  • 创建或传递特定类型的资产实例

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 资产节点通常要求连接已加载的资产实例。
  • 父类 Asset 生命周期能力应优先使用通用资产管理节点。

获取 TMX 文本

读出 TiledMapAsset 内存储的 TMX XML 文本(即 Tiled 地图文件的原始 XML 内容)。 该字符串包含地图的图层、图块集引用、属性等全部布局信息。可通过 设置 TMX 文本 节点写回修改后的内容,但写回后需通过 TiledMap 组件的 tmxAsset 重新赋值才能生效。

节点信息

字段
节点 IDtiledMapAssetGetTmxXmlText
分类资产
二级分类瓦片地图
分组TiledMapAsset
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
tiledMapAsset地图资产数据cc.Asset / TiledMapAssetTiledMapAsset 地图资产
这里需要连接一个已经加载好的 TiledMapAsset 实例。
TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。
该端口没有”选择地图资产”按钮,请先使用以下方式获取实例:
- 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。
- 获取资产:取出资产包里已加载的 TiledMapAsset。
-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
tmxXmlTextTMX 文本数据stringTMX XML 文本
地图资产中存储的原始 TMX 格式 XML 字符串,包含图层、图块集引用、属性等全部布局信息。
-可选

使用场景

  • 读取音频时长、图片尺寸、材质参数等资产信息
  • 校验加载结果是否可用
  • 创建或传递特定类型的资产实例

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 资产节点通常要求连接已加载的资产实例。
  • 父类 Asset 生命周期能力应优先使用通用资产管理节点。

获取 TSX 文件名数组

读出 TiledMapAsset 存储的所有 TSX 文件名字符串数组,与 tsxFiles 并行对应。

节点信息

字段
节点 IDtiledMapAssetGetTsxFileNames
分类资产
二级分类瓦片地图
分组TiledMapAsset
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
tiledMapAsset地图资产数据cc.Asset / TiledMapAssetTiledMapAsset 地图资产
这里需要连接一个已经加载好的 TiledMapAsset 实例。
TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。
该端口没有”选择地图资产”按钮,请先使用以下方式获取实例:
- 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。
- 获取资产:取出资产包里已加载的 TiledMapAsset。
-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
tsxFileNamesTSX 文件名数组数据string / arrayTSX 文件名数组
图块集文件的名称列表,与 tsxFiles 并行。
-可选
tsxFileNameCountTSX 文件名数量数据numberTSX 文件名数量
tsxFileNames 数组的元素数量。
-可选

使用场景

  • 读取音频时长、图片尺寸、材质参数等资产信息
  • 校验加载结果是否可用
  • 创建或传递特定类型的资产实例

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 资产节点通常要求连接已加载的资产实例。
  • 父类 Asset 生命周期能力应优先使用通用资产管理节点。

获取 TSX 文件数组

读出 TiledMapAsset 引用的所有 TSX 文件(TextAsset 数组)。每个 TSX 文件定义了一个图块集(Tileset),与 tsxFileNames 并行对应。

节点信息

字段
节点 IDtiledMapAssetGetTsxFiles
分类资产
二级分类瓦片地图
分组TiledMapAsset
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
tiledMapAsset地图资产数据cc.Asset / TiledMapAssetTiledMapAsset 地图资产
这里需要连接一个已经加载好的 TiledMapAsset 实例。
TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。
该端口没有”选择地图资产”按钮,请先使用以下方式获取实例:
- 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。
- 获取资产:取出资产包里已加载的 TiledMapAsset。
-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
tsxFilesTSX 文件数组数据cc.Asset / array / TextAssetTSX 文件数组
地图资产引用的 TSX 图块集文件列表,与 tsxFileNames 并行。
-可选
tsxFileCountTSX 文件数量数据numberTSX 文件数量
tsxFiles 数组的元素数量。
-可选

使用场景

  • 读取音频时长、图片尺寸、材质参数等资产信息
  • 校验加载结果是否可用
  • 创建或传递特定类型的资产实例

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 资产节点通常要求连接已加载的资产实例。
  • 父类 Asset 生命周期能力应优先使用通用资产管理节点。

获取所有属性

一次性读出 TiledMapAsset 的全部已节点化字段:TMX 文本、TSX 文件列表及名称列表、图块 SpriteFrame 列表及名称列表及尺寸列表、图片图层 SpriteFrame 列表及名称列表。等同于连接多个 获取类节点,但只用一个节点即可。

节点信息

字段
节点 IDtiledMapAssetGetProperties
分类资产
二级分类瓦片地图
分组TiledMapAsset
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
tiledMapAsset地图资产数据cc.Asset / TiledMapAssetTiledMapAsset 地图资产
这里需要连接一个已经加载好的 TiledMapAsset 实例。
TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。
该端口没有”选择地图资产”按钮,请先使用以下方式获取实例:
- 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。
- 获取资产:取出资产包里已加载的 TiledMapAsset。
-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
tmxXmlTextTMX 文本数据stringTMX XML 文本
地图 TMX 格式的 XML 字符串。
-可选
tsxFilesTSX 文件数组数据cc.Asset / array / TextAssetTSX 文件数组
地图引用的 TSX 图块集文件列表。
-可选
tsxFileCountTSX 文件数量数据numberTSX 文件数量
tsxFiles 的元素数量。
-可选
tsxFileNamesTSX 文件名数组数据string / arrayTSX 文件名数组
图块集文件名称列表。
-可选
spriteFrames图块精灵帧数组数据cc.Asset / array / SpriteFrame图块 SpriteFrame 数组
地图图块集的贴图帧列表。
-可选
spriteFrameCount图块精灵帧数量数据number图块精灵帧数量
spriteFrames 的元素数量。
-可选
spriteFrameNames图块精灵帧名称数组数据string / array图块名称数组
图块集中各帧的名称列表。
-可选
spriteFrameSizes图块精灵帧尺寸数组数据size / array图块尺寸数组
图块集中各帧的 Size 列表。
-可选
imageLayerSpriteFrames图片图层精灵帧数组数据cc.Asset / array / SpriteFrame图片图层 SpriteFrame 数组
图片图层的贴图帧列表。
-可选
imageLayerSpriteFrameNames图片图层精灵帧名称数组数据string / array图片图层名称数组
图片图层的名称列表。
-可选

使用场景

  • 读取音频时长、图片尺寸、材质参数等资产信息
  • 校验加载结果是否可用
  • 创建或传递特定类型的资产实例

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 资产节点通常要求连接已加载的资产实例。
  • 父类 Asset 生命周期能力应优先使用通用资产管理节点。

获取图块精灵帧尺寸数组

读出 TiledMapAsset 内存储的图块尺寸数组,与 spriteFrames 和 spriteFrameNames 并行对应。

节点信息

字段
节点 IDtiledMapAssetGetSpriteFrameSizes
分类资产
二级分类瓦片地图
分组TiledMapAsset
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
tiledMapAsset地图资产数据cc.Asset / TiledMapAssetTiledMapAsset 地图资产
这里需要连接一个已经加载好的 TiledMapAsset 实例。
TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。
该端口没有”选择地图资产”按钮,请先使用以下方式获取实例:
- 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。
- 获取资产:取出资产包里已加载的 TiledMapAsset。
-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
spriteFrameSizes图块精灵帧尺寸数组数据size / array图块尺寸数组
图块集中各帧的尺寸列表(宽/高),与 spriteFrames / spriteFrameNames 并行。
-可选
spriteFrameSizeCount图块精灵帧尺寸数量数据number图块尺寸数量
spriteFrameSizes 数组的元素数量。
-可选

使用场景

  • 读取音频时长、图片尺寸、材质参数等资产信息
  • 校验加载结果是否可用
  • 创建或传递特定类型的资产实例

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 资产节点通常要求连接已加载的资产实例。
  • 父类 Asset 生命周期能力应优先使用通用资产管理节点。

获取图块精灵帧名称数组

读出 TiledMapAsset 内存储的图块名称字符串数组,与 spriteFrames 和 spriteFrameSizes 并行对应。

节点信息

字段
节点 IDtiledMapAssetGetSpriteFrameNames
分类资产
二级分类瓦片地图
分组TiledMapAsset
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
tiledMapAsset地图资产数据cc.Asset / TiledMapAssetTiledMapAsset 地图资产
这里需要连接一个已经加载好的 TiledMapAsset 实例。
TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。
该端口没有”选择地图资产”按钮,请先使用以下方式获取实例:
- 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。
- 获取资产:取出资产包里已加载的 TiledMapAsset。
-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
spriteFrameNames图块精灵帧名称数组数据string / array图块名称数组
图块集中各帧的名称列表,与 spriteFrames / spriteFrameSizes 并行。
-可选
spriteFrameNameCount图块精灵帧名称数量数据number图块名称数量
spriteFrameNames 数组的元素数量。
-可选

使用场景

  • 读取音频时长、图片尺寸、材质参数等资产信息
  • 校验加载结果是否可用
  • 创建或传递特定类型的资产实例

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 资产节点通常要求连接已加载的资产实例。
  • 父类 Asset 生命周期能力应优先使用通用资产管理节点。

获取图块精灵帧数组

读出 TiledMapAsset 内存储的图块 SpriteFrame 数组,与 spriteFrameNames 和 spriteFrameSizes 并行对应。 数组中的每个 SpriteFrame 对应地图中一个图块集(Tileset)的贴图。

节点信息

字段
节点 IDtiledMapAssetGetSpriteFrames
分类资产
二级分类瓦片地图
分组TiledMapAsset
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
tiledMapAsset地图资产数据cc.Asset / TiledMapAssetTiledMapAsset 地图资产
这里需要连接一个已经加载好的 TiledMapAsset 实例。
TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。
该端口没有”选择地图资产”按钮,请先使用以下方式获取实例:
- 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。
- 获取资产:取出资产包里已加载的 TiledMapAsset。
-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
spriteFrames图块精灵帧数组数据cc.Asset / array / SpriteFrame图块 SpriteFrame 数组
地图图块集对应的贴图帧列表,与 spriteFrameNames / spriteFrameSizes 并行。
-可选
spriteFrameCount图块精灵帧数量数据number图块精灵帧数量
spriteFrames 数组的元素数量。
-可选

使用场景

  • 读取音频时长、图片尺寸、材质参数等资产信息
  • 校验加载结果是否可用
  • 创建或传递特定类型的资产实例

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 资产节点通常要求连接已加载的资产实例。
  • 父类 Asset 生命周期能力应优先使用通用资产管理节点。

获取图片图层精灵帧名称数组

读出 TiledMapAsset 内存储的图片图层名称字符串数组,与 imageLayerSpriteFrames 并行对应。

节点信息

字段
节点 IDtiledMapAssetGetImageLayerSpriteFrameNames
分类资产
二级分类瓦片地图
分组TiledMapAsset
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
tiledMapAsset地图资产数据cc.Asset / TiledMapAssetTiledMapAsset 地图资产
这里需要连接一个已经加载好的 TiledMapAsset 实例。
TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。
该端口没有”选择地图资产”按钮,请先使用以下方式获取实例:
- 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。
- 获取资产:取出资产包里已加载的 TiledMapAsset。
-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
imageLayerSpriteFrameNames图片图层精灵帧名称数组数据string / array图片图层名称数组
图片图层的名称列表,与 imageLayerSpriteFrames 并行。
-可选
imageLayerSpriteFrameNameCount图片图层精灵帧名称数量数据number图片图层名称数量
imageLayerSpriteFrameNames 数组的元素数量。
-可选

使用场景

  • 读取音频时长、图片尺寸、材质参数等资产信息
  • 校验加载结果是否可用
  • 创建或传递特定类型的资产实例

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 资产节点通常要求连接已加载的资产实例。
  • 父类 Asset 生命周期能力应优先使用通用资产管理节点。

获取图片图层精灵帧数组

读出 TiledMapAsset 内存储的图片图层 SpriteFrame 数组,与 imageLayerSpriteFrameNames 并行对应。 Tiled 地图中的图片图层(Image Layer)将整张图片作为一层绘制,每张图片对应一个 SpriteFrame。

节点信息

字段
节点 IDtiledMapAssetGetImageLayerSpriteFrames
分类资产
二级分类瓦片地图
分组TiledMapAsset
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
tiledMapAsset地图资产数据cc.Asset / TiledMapAssetTiledMapAsset 地图资产
这里需要连接一个已经加载好的 TiledMapAsset 实例。
TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。
该端口没有”选择地图资产”按钮,请先使用以下方式获取实例:
- 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。
- 获取资产:取出资产包里已加载的 TiledMapAsset。
-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
imageLayerSpriteFrames图片图层精灵帧数组数据cc.Asset / array / SpriteFrame图片图层 SpriteFrame 数组
地图图片图层对应的贴图帧列表,与 imageLayerSpriteFrameNames 并行。
-可选
imageLayerSpriteFrameCount图片图层精灵帧数量数据number图片图层精灵帧数量
imageLayerSpriteFrames 数组的元素数量。
-可选

使用场景

  • 读取音频时长、图片尺寸、材质参数等资产信息
  • 校验加载结果是否可用
  • 创建或传递特定类型的资产实例

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 资产节点通常要求连接已加载的资产实例。
  • 父类 Asset 生命周期能力应优先使用通用资产管理节点。

设置 TMX 文本

将 TMX XML 文本写入 TiledMapAsset。 注意:修改 TiledMapAsset 字段不会自动刷新已挂载的 TiledMap 组件。若需让组件重新解析地图,请在后续通过组件分类节点显式重新设置 TiledMap.tmxAsset。

节点信息

字段
节点 IDtiledMapAssetSetTmxXmlText
分类资产
二级分类瓦片地图
分组TiledMapAsset
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
exe-执行流执行流执行入口-可选
tiledMapAsset地图资产数据cc.Asset / TiledMapAssetTiledMapAsset 地图资产
这里需要连接一个已经加载好的 TiledMapAsset 实例。
TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。
该端口没有”选择地图资产”按钮,请先使用以下方式获取实例:
- 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。
- 获取资产:取出资产包里已加载的 TiledMapAsset。
-必填
tmxXmlTextTMX 文本数据stringTMX XML 文本
要写入的 TMX 格式 XML 字符串。不提供内联输入控件——请通过连线传入。
-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
out-执行流执行流执行完成-可选
tiledMapAsset地图资产数据cc.Asset / TiledMapAssetTiledMapAsset(透传)
把当前操作的 TiledMapAsset 实例原样传出,便于将多个配置节点串联在一起。
-可选

使用场景

  • 读取音频时长、图片尺寸、材质参数等资产信息
  • 校验加载结果是否可用
  • 创建或传递特定类型的资产实例

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 资产节点通常要求连接已加载的资产实例。
  • 父类 Asset 生命周期能力应优先使用通用资产管理节点。

设置 TSX 文件名数组

将 TSX 文件名字符串数组写入 TiledMapAsset。 注意:替换此数组时需保证与 tsxFiles 并行对应。 注意:修改 TiledMapAsset 字段不会自动刷新已挂载的 TiledMap 组件。若需让组件重新解析地图,请在后续通过组件分类节点显式重新设置 TiledMap.tmxAsset。

节点信息

字段
节点 IDtiledMapAssetSetTsxFileNames
分类资产
二级分类瓦片地图
分组TiledMapAsset
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
exe-执行流执行流执行入口-可选
tiledMapAsset地图资产数据cc.Asset / TiledMapAssetTiledMapAsset 地图资产
这里需要连接一个已经加载好的 TiledMapAsset 实例。
TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。
该端口没有”选择地图资产”按钮,请先使用以下方式获取实例:
- 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。
- 获取资产:取出资产包里已加载的 TiledMapAsset。
-必填
tsxFileNamesTSX 文件名数组数据string / arrayTSX 文件名数组
要写入的图块集文件名数组,需与 tsxFiles 并行。
-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
out-执行流执行流执行完成-可选
tiledMapAsset地图资产数据cc.Asset / TiledMapAssetTiledMapAsset(透传)
把当前操作的 TiledMapAsset 实例原样传出,便于将多个配置节点串联在一起。
-可选

使用场景

  • 读取音频时长、图片尺寸、材质参数等资产信息
  • 校验加载结果是否可用
  • 创建或传递特定类型的资产实例

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 资产节点通常要求连接已加载的资产实例。
  • 父类 Asset 生命周期能力应优先使用通用资产管理节点。

设置 TSX 文件数组

将 TSX 文件数组(TextAsset[])写入 TiledMapAsset。 注意:替换此数组时需保证与 tsxFileNames 并行对应,否则地图解析会出错。 注意:修改 TiledMapAsset 字段不会自动刷新已挂载的 TiledMap 组件。若需让组件重新解析地图,请在后续通过组件分类节点显式重新设置 TiledMap.tmxAsset。

节点信息

字段
节点 IDtiledMapAssetSetTsxFiles
分类资产
二级分类瓦片地图
分组TiledMapAsset
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
exe-执行流执行流执行入口-可选
tiledMapAsset地图资产数据cc.Asset / TiledMapAssetTiledMapAsset 地图资产
这里需要连接一个已经加载好的 TiledMapAsset 实例。
TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。
该端口没有”选择地图资产”按钮,请先使用以下方式获取实例:
- 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。
- 获取资产:取出资产包里已加载的 TiledMapAsset。
-必填
tsxFilesTSX 文件数组数据cc.Asset / array / TextAssetTSX 文件数组
要写入的图块集文件数组,需与 tsxFileNames 并行。
-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
out-执行流执行流执行完成-可选
tiledMapAsset地图资产数据cc.Asset / TiledMapAssetTiledMapAsset(透传)
把当前操作的 TiledMapAsset 实例原样传出,便于将多个配置节点串联在一起。
-可选

使用场景

  • 读取音频时长、图片尺寸、材质参数等资产信息
  • 校验加载结果是否可用
  • 创建或传递特定类型的资产实例

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 资产节点通常要求连接已加载的资产实例。
  • 父类 Asset 生命周期能力应优先使用通用资产管理节点。

设置所有属性

一次性批量写入 TiledMapAsset 的多个可写字段。写入顺序:tmxXmlText → tsxFiles → tsxFileNames → spriteFrames → spriteFrameNames → spriteFrameSizes → imageLayerSpriteFrames → imageLayerSpriteFrameNames。 公开引脚语义(重要):除 exe 与 tiledMapAsset 外,所有可写属性引脚默认不公开(isPublic: false),只有被显式公开的引脚才参与写入。若想保留目标属性原值不变,必须保持引脚不公开——仅断开连线不够,已公开的引脚会用内联控件默认值覆盖原值。 注意:修改 TiledMapAsset 字段不会自动刷新已挂载的 TiledMap 组件。若需让组件重新解析地图,请在后续通过组件分类节点显式重新设置 TiledMap.tmxAsset。

节点信息

字段
节点 IDtiledMapAssetSetProperties
分类资产
二级分类瓦片地图
分组TiledMapAsset
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
exe-执行流执行流执行入口-可选
tiledMapAsset地图资产数据cc.Asset / TiledMapAssetTiledMapAsset 地图资产
这里需要连接一个已经加载好的 TiledMapAsset 实例。
TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。
该端口没有”选择地图资产”按钮,请先使用以下方式获取实例:
- 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。
- 获取资产:取出资产包里已加载的 TiledMapAsset。
-必填
tmxXmlTextTMX 文本数据stringTMX XML 文本
要写入的 TMX 文本。默认不公开;公开后才参与写入。
-可选
默认隐藏
tsxFilesTSX 文件数组数据cc.Asset / array / TextAssetTSX 文件数组
要写入的 TSX 文件列表。默认不公开;公开后才参与写入。
-可选
默认隐藏
tsxFileNamesTSX 文件名数组数据string / arrayTSX 文件名数组
要写入的 TSX 文件名列表。默认不公开;公开后才参与写入。
-可选
默认隐藏
spriteFrames图块精灵帧数组数据cc.Asset / array / SpriteFrame图块 SpriteFrame 数组
要写入的图块集贴图帧列表。默认不公开;公开后才参与写入。
-可选
默认隐藏
spriteFrameNames图块精灵帧名称数组数据string / array图块名称数组
要写入的图块名称列表。默认不公开;公开后才参与写入。
-可选
默认隐藏
spriteFrameSizes图块精灵帧尺寸数组数据size / array图块尺寸数组
要写入的图块尺寸列表。默认不公开;公开后才参与写入。
-可选
默认隐藏
imageLayerSpriteFrames图片图层精灵帧数组数据cc.Asset / array / SpriteFrame图片图层 SpriteFrame 数组
要写入的图片图层贴图帧列表。默认不公开;公开后才参与写入。
-可选
默认隐藏
imageLayerSpriteFrameNames图片图层精灵帧名称数组数据string / array图片图层名称数组
要写入的图片图层名称列表。默认不公开;公开后才参与写入。
-可选
默认隐藏

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
out-执行流执行流执行完成-可选
tiledMapAsset地图资产数据cc.Asset / TiledMapAssetTiledMapAsset(透传)
把当前操作的 TiledMapAsset 实例原样传出,便于将多个配置节点串联在一起。
-可选

使用场景

  • 读取音频时长、图片尺寸、材质参数等资产信息
  • 校验加载结果是否可用
  • 创建或传递特定类型的资产实例

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 资产节点通常要求连接已加载的资产实例。
  • 父类 Asset 生命周期能力应优先使用通用资产管理节点。

设置图块精灵帧尺寸数组

将图块尺寸数组写入 TiledMapAsset。 注意:替换此数组时需保证与 spriteFrames 和 spriteFrameNames 并行对应。 注意:修改 TiledMapAsset 字段不会自动刷新已挂载的 TiledMap 组件。若需让组件重新解析地图,请在后续通过组件分类节点显式重新设置 TiledMap.tmxAsset。

节点信息

字段
节点 IDtiledMapAssetSetSpriteFrameSizes
分类资产
二级分类瓦片地图
分组TiledMapAsset
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
exe-执行流执行流执行入口-可选
tiledMapAsset地图资产数据cc.Asset / TiledMapAssetTiledMapAsset 地图资产
这里需要连接一个已经加载好的 TiledMapAsset 实例。
TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。
该端口没有”选择地图资产”按钮,请先使用以下方式获取实例:
- 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。
- 获取资产:取出资产包里已加载的 TiledMapAsset。
-必填
spriteFrameSizes图块精灵帧尺寸数组数据size / array图块尺寸数组
要写入的图块尺寸列表,需与 spriteFrames / spriteFrameNames 并行。
-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
out-执行流执行流执行完成-可选
tiledMapAsset地图资产数据cc.Asset / TiledMapAssetTiledMapAsset(透传)
把当前操作的 TiledMapAsset 实例原样传出,便于将多个配置节点串联在一起。
-可选

使用场景

  • 读取音频时长、图片尺寸、材质参数等资产信息
  • 校验加载结果是否可用
  • 创建或传递特定类型的资产实例

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 资产节点通常要求连接已加载的资产实例。
  • 父类 Asset 生命周期能力应优先使用通用资产管理节点。

设置图块精灵帧名称数组

将图块名称字符串数组写入 TiledMapAsset。 注意:替换此数组时需保证与 spriteFrames 和 spriteFrameSizes 并行对应。 注意:修改 TiledMapAsset 字段不会自动刷新已挂载的 TiledMap 组件。若需让组件重新解析地图,请在后续通过组件分类节点显式重新设置 TiledMap.tmxAsset。

节点信息

字段
节点 IDtiledMapAssetSetSpriteFrameNames
分类资产
二级分类瓦片地图
分组TiledMapAsset
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
exe-执行流执行流执行入口-可选
tiledMapAsset地图资产数据cc.Asset / TiledMapAssetTiledMapAsset 地图资产
这里需要连接一个已经加载好的 TiledMapAsset 实例。
TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。
该端口没有”选择地图资产”按钮,请先使用以下方式获取实例:
- 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。
- 获取资产:取出资产包里已加载的 TiledMapAsset。
-必填
spriteFrameNames图块精灵帧名称数组数据string / array图块名称数组
要写入的图块名称列表,需与 spriteFrames / spriteFrameSizes 并行。
-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
out-执行流执行流执行完成-可选
tiledMapAsset地图资产数据cc.Asset / TiledMapAssetTiledMapAsset(透传)
把当前操作的 TiledMapAsset 实例原样传出,便于将多个配置节点串联在一起。
-可选

使用场景

  • 读取音频时长、图片尺寸、材质参数等资产信息
  • 校验加载结果是否可用
  • 创建或传递特定类型的资产实例

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 资产节点通常要求连接已加载的资产实例。
  • 父类 Asset 生命周期能力应优先使用通用资产管理节点。

设置图块精灵帧数组

将图块 SpriteFrame 数组写入 TiledMapAsset。 注意:替换此数组时需保证与 spriteFrameNames 和 spriteFrameSizes 并行对应。 注意:修改 TiledMapAsset 字段不会自动刷新已挂载的 TiledMap 组件。若需让组件重新解析地图,请在后续通过组件分类节点显式重新设置 TiledMap.tmxAsset。

节点信息

字段
节点 IDtiledMapAssetSetSpriteFrames
分类资产
二级分类瓦片地图
分组TiledMapAsset
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
exe-执行流执行流执行入口-可选
tiledMapAsset地图资产数据cc.Asset / TiledMapAssetTiledMapAsset 地图资产
这里需要连接一个已经加载好的 TiledMapAsset 实例。
TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。
该端口没有”选择地图资产”按钮,请先使用以下方式获取实例:
- 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。
- 获取资产:取出资产包里已加载的 TiledMapAsset。
-必填
spriteFrames图块精灵帧数组数据cc.Asset / array / SpriteFrame图块 SpriteFrame 数组
要写入的图块集贴图帧数组,需与 spriteFrameNames / spriteFrameSizes 并行。
-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
out-执行流执行流执行完成-可选
tiledMapAsset地图资产数据cc.Asset / TiledMapAssetTiledMapAsset(透传)
把当前操作的 TiledMapAsset 实例原样传出,便于将多个配置节点串联在一起。
-可选

使用场景

  • 读取音频时长、图片尺寸、材质参数等资产信息
  • 校验加载结果是否可用
  • 创建或传递特定类型的资产实例

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 资产节点通常要求连接已加载的资产实例。
  • 父类 Asset 生命周期能力应优先使用通用资产管理节点。

设置图片图层精灵帧名称数组

将图片图层名称字符串数组写入 TiledMapAsset。 注意:替换此数组时需保证与 imageLayerSpriteFrames 并行对应。 注意:修改 TiledMapAsset 字段不会自动刷新已挂载的 TiledMap 组件。若需让组件重新解析地图,请在后续通过组件分类节点显式重新设置 TiledMap.tmxAsset。

节点信息

字段
节点 IDtiledMapAssetSetImageLayerSpriteFrameNames
分类资产
二级分类瓦片地图
分组TiledMapAsset
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
exe-执行流执行流执行入口-可选
tiledMapAsset地图资产数据cc.Asset / TiledMapAssetTiledMapAsset 地图资产
这里需要连接一个已经加载好的 TiledMapAsset 实例。
TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。
该端口没有”选择地图资产”按钮,请先使用以下方式获取实例:
- 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。
- 获取资产:取出资产包里已加载的 TiledMapAsset。
-必填
imageLayerSpriteFrameNames图片图层精灵帧名称数组数据string / array图片图层名称数组
要写入的图片图层名称列表,需与 imageLayerSpriteFrames 并行。
-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
out-执行流执行流执行完成-可选
tiledMapAsset地图资产数据cc.Asset / TiledMapAssetTiledMapAsset(透传)
把当前操作的 TiledMapAsset 实例原样传出,便于将多个配置节点串联在一起。
-可选

使用场景

  • 读取音频时长、图片尺寸、材质参数等资产信息
  • 校验加载结果是否可用
  • 创建或传递特定类型的资产实例

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 资产节点通常要求连接已加载的资产实例。
  • 父类 Asset 生命周期能力应优先使用通用资产管理节点。

设置图片图层精灵帧数组

将图片图层 SpriteFrame 数组写入 TiledMapAsset。 注意:替换此数组时需保证与 imageLayerSpriteFrameNames 并行对应。 注意:修改 TiledMapAsset 字段不会自动刷新已挂载的 TiledMap 组件。若需让组件重新解析地图,请在后续通过组件分类节点显式重新设置 TiledMap.tmxAsset。

节点信息

字段
节点 IDtiledMapAssetSetImageLayerSpriteFrames
分类资产
二级分类瓦片地图
分组TiledMapAsset
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
exe-执行流执行流执行入口-可选
tiledMapAsset地图资产数据cc.Asset / TiledMapAssetTiledMapAsset 地图资产
这里需要连接一个已经加载好的 TiledMapAsset 实例。
TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。
该端口没有”选择地图资产”按钮,请先使用以下方式获取实例:
- 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。
- 获取资产:取出资产包里已加载的 TiledMapAsset。
-必填
imageLayerSpriteFrames图片图层精灵帧数组数据cc.Asset / array / SpriteFrame图片图层 SpriteFrame 数组
要写入的图片图层贴图帧数组,需与 imageLayerSpriteFrameNames 并行。
-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
out-执行流执行流执行完成-可选
tiledMapAsset地图资产数据cc.Asset / TiledMapAssetTiledMapAsset(透传)
把当前操作的 TiledMapAsset 实例原样传出,便于将多个配置节点串联在一起。
-可选

使用场景

  • 读取音频时长、图片尺寸、材质参数等资产信息
  • 校验加载结果是否可用
  • 创建或传递特定类型的资产实例

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 资产节点通常要求连接已加载的资产实例。
  • 父类 Asset 生命周期能力应优先使用通用资产管理节点。

新建地图资产

在游戏运行时创建一个全新的空 TiledMapAsset 实例,不含任何 TMX 文本、TSX 依赖或 SpriteFrame 映射数据。 需配合 设置 TMX 文本、设置 TSX 文件数组、设置图块精灵帧数组 等节点填充内容后才能被 TiledMap 组件正确解析。若只是加载已有地图资产,请改用 加载资产 节点(类型选 TILED_MAP_ASSET)。

节点信息

字段
节点 IDtiledMapAssetCreate
分类资产
二级分类瓦片地图
分组TiledMapAsset
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
exe-执行流执行流执行入口-可选

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
out-执行流执行流执行完成-可选
tiledMapAsset地图资产数据cc.Asset / TiledMapAssetTiledMapAsset 实例
新建的空地图资产实例。请继续连接 设置 TMX 文本、设置 TSX 文件数组、设置图块精灵帧数组 等节点为其填充内容。
-可选

使用场景

  • 读取音频时长、图片尺寸、材质参数等资产信息
  • 校验加载结果是否可用
  • 创建或传递特定类型的资产实例

注意事项

  • 适合的工作流类型:component、library、method、function、class。
  • 资产节点通常要求连接已加载的资产实例。
  • 父类 Asset 生命周期能力应优先使用通用资产管理节点。