使用指南
资产 / 瓦片地图 / TiledMapAsset节点
资产 / 瓦片地图 / TiledMapAsset 节点手册,包含 22 个节点的用途、引脚、使用场景和注意事项。
学习目标
读取和验证 Cocos 资产对象,把图片、音频、材质、Prefab 等资源接入工作流逻辑。
覆盖范围
- 节点数量:22
- 分类路径:资产 / 瓦片地图 / TiledMapAsset
典型使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
通用注意事项
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
节点索引
| 节点 | 节点 ID | 输入/输出 | 执行方式 |
|---|---|---|---|
| 按名称查找 TSX 文件 | tiledMapAssetFindTsxFileByName | 2 / 3 | 立即继续 |
| 按名称查找图块精灵帧 | tiledMapAssetFindSpriteFrameByName | 2 / 4 | 立即继续 |
| 按名称查找图片图层精灵帧 | tiledMapAssetFindImageLayerSpriteFrameByName | 2 / 3 | 立即继续 |
| 获取 TMX 文本 | tiledMapAssetGetTmxXmlText | 1 / 1 | 立即继续 |
| 获取 TSX 文件名数组 | tiledMapAssetGetTsxFileNames | 1 / 2 | 立即继续 |
| 获取 TSX 文件数组 | tiledMapAssetGetTsxFiles | 1 / 2 | 立即继续 |
| 获取所有属性 | tiledMapAssetGetProperties | 1 / 10 | 立即继续 |
| 获取图块精灵帧尺寸数组 | tiledMapAssetGetSpriteFrameSizes | 1 / 2 | 立即继续 |
| 获取图块精灵帧名称数组 | tiledMapAssetGetSpriteFrameNames | 1 / 2 | 立即继续 |
| 获取图块精灵帧数组 | tiledMapAssetGetSpriteFrames | 1 / 2 | 立即继续 |
| 获取图片图层精灵帧名称数组 | tiledMapAssetGetImageLayerSpriteFrameNames | 1 / 2 | 立即继续 |
| 获取图片图层精灵帧数组 | tiledMapAssetGetImageLayerSpriteFrames | 1 / 2 | 立即继续 |
| 设置 TMX 文本 | tiledMapAssetSetTmxXmlText | 3 / 2 | 立即继续 |
| 设置 TSX 文件名数组 | tiledMapAssetSetTsxFileNames | 3 / 2 | 立即继续 |
| 设置 TSX 文件数组 | tiledMapAssetSetTsxFiles | 3 / 2 | 立即继续 |
| 设置所有属性 | tiledMapAssetSetProperties | 10 / 2 | 立即继续 |
| 设置图块精灵帧尺寸数组 | tiledMapAssetSetSpriteFrameSizes | 3 / 2 | 立即继续 |
| 设置图块精灵帧名称数组 | tiledMapAssetSetSpriteFrameNames | 3 / 2 | 立即继续 |
| 设置图块精灵帧数组 | tiledMapAssetSetSpriteFrames | 3 / 2 | 立即继续 |
| 设置图片图层精灵帧名称数组 | tiledMapAssetSetImageLayerSpriteFrameNames | 3 / 2 | 立即继续 |
| 设置图片图层精灵帧数组 | tiledMapAssetSetImageLayerSpriteFrames | 3 / 2 | 立即继续 |
| 新建地图资产 | tiledMapAssetCreate | 1 / 2 | 立即继续 |
按名称查找 TSX 文件
通过 tsxFileNames 与 tsxFiles 并行数组按名称查找目标 TSX 文件。 注意:名称匹配区分大小写,且依赖资产导入时写入的名称数组。若未找到,exists 输出 false,tsxFile 和 index 输出安全默认值(null / -1)。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | tiledMapAssetFindTsxFileByName |
| 分类 | 资产 |
| 二级分类 | 瓦片地图 |
| 分组 | TiledMapAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
tiledMapAsset | 地图资产 | 数据 | cc.Asset / TiledMapAsset | TiledMapAsset 地图资产 这里需要连接一个已经加载好的 TiledMapAsset 实例。 TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。 该端口没有”选择地图资产”按钮,请先使用以下方式获取实例: - 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。 - 获取资产:取出资产包里已加载的 TiledMapAsset。 | - | 必填 |
tsxFileName | TSX 文件名 | 数据 | string | TSX 文件名 要查找的 TSX 文件名称(区分大小写)。 | 输入框 默认值:"" | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
tsxFile | TSX 文件 | 数据 | cc.Asset / TextAsset | TSX 文件 找到的 TSX 文件实例;未找到时为 null。 | - | 可选 |
index | 索引 | 数据 | number | 索引 找到的 TSX 文件在并行数组中的位置索引;未找到时为 -1。 | - | 可选 |
exists | 是否存在 | 数据 | boolean | 是否存在 true:成功找到指定名称的 TSX 文件;false:未找到。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
按名称查找图块精灵帧
通过 spriteFrameNames / spriteFrames / spriteFrameSizes 并行数组按名称查找图块 SpriteFrame。 注意:名称匹配区分大小写,且依赖资产导入时写入的名称数组。若未找到,exists 为 false,其他输出返回安全默认值。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | tiledMapAssetFindSpriteFrameByName |
| 分类 | 资产 |
| 二级分类 | 瓦片地图 |
| 分组 | TiledMapAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
tiledMapAsset | 地图资产 | 数据 | cc.Asset / TiledMapAsset | TiledMapAsset 地图资产 这里需要连接一个已经加载好的 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,其他输出返回安全默认值。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | tiledMapAssetFindImageLayerSpriteFrameByName |
| 分类 | 资产 |
| 二级分类 | 瓦片地图 |
| 分组 | TiledMapAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
tiledMapAsset | 地图资产 | 数据 | cc.Asset / TiledMapAsset | TiledMapAsset 地图资产 这里需要连接一个已经加载好的 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 重新赋值才能生效。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | tiledMapAssetGetTmxXmlText |
| 分类 | 资产 |
| 二级分类 | 瓦片地图 |
| 分组 | TiledMapAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
tiledMapAsset | 地图资产 | 数据 | cc.Asset / TiledMapAsset | TiledMapAsset 地图资产 这里需要连接一个已经加载好的 TiledMapAsset 实例。 TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。 该端口没有”选择地图资产”按钮,请先使用以下方式获取实例: - 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。 - 获取资产:取出资产包里已加载的 TiledMapAsset。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
tmxXmlText | TMX 文本 | 数据 | string | TMX XML 文本 地图资产中存储的原始 TMX 格式 XML 字符串,包含图层、图块集引用、属性等全部布局信息。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
获取 TSX 文件名数组
读出 TiledMapAsset 存储的所有 TSX 文件名字符串数组,与 tsxFiles 并行对应。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | tiledMapAssetGetTsxFileNames |
| 分类 | 资产 |
| 二级分类 | 瓦片地图 |
| 分组 | TiledMapAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
tiledMapAsset | 地图资产 | 数据 | cc.Asset / TiledMapAsset | TiledMapAsset 地图资产 这里需要连接一个已经加载好的 TiledMapAsset 实例。 TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。 该端口没有”选择地图资产”按钮,请先使用以下方式获取实例: - 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。 - 获取资产:取出资产包里已加载的 TiledMapAsset。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
tsxFileNames | TSX 文件名数组 | 数据 | string / array | TSX 文件名数组 图块集文件的名称列表,与 tsxFiles 并行。 | - | 可选 |
tsxFileNameCount | TSX 文件名数量 | 数据 | number | TSX 文件名数量 tsxFileNames 数组的元素数量。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
获取 TSX 文件数组
读出 TiledMapAsset 引用的所有 TSX 文件(TextAsset 数组)。每个 TSX 文件定义了一个图块集(Tileset),与 tsxFileNames 并行对应。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | tiledMapAssetGetTsxFiles |
| 分类 | 资产 |
| 二级分类 | 瓦片地图 |
| 分组 | TiledMapAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
tiledMapAsset | 地图资产 | 数据 | cc.Asset / TiledMapAsset | TiledMapAsset 地图资产 这里需要连接一个已经加载好的 TiledMapAsset 实例。 TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。 该端口没有”选择地图资产”按钮,请先使用以下方式获取实例: - 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。 - 获取资产:取出资产包里已加载的 TiledMapAsset。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
tsxFiles | TSX 文件数组 | 数据 | cc.Asset / array / TextAsset | TSX 文件数组 地图资产引用的 TSX 图块集文件列表,与 tsxFileNames 并行。 | - | 可选 |
tsxFileCount | TSX 文件数量 | 数据 | number | TSX 文件数量 tsxFiles 数组的元素数量。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
获取所有属性
一次性读出 TiledMapAsset 的全部已节点化字段:TMX 文本、TSX 文件列表及名称列表、图块 SpriteFrame 列表及名称列表及尺寸列表、图片图层 SpriteFrame 列表及名称列表。等同于连接多个 获取类节点,但只用一个节点即可。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | tiledMapAssetGetProperties |
| 分类 | 资产 |
| 二级分类 | 瓦片地图 |
| 分组 | TiledMapAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
tiledMapAsset | 地图资产 | 数据 | cc.Asset / TiledMapAsset | TiledMapAsset 地图资产 这里需要连接一个已经加载好的 TiledMapAsset 实例。 TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。 该端口没有”选择地图资产”按钮,请先使用以下方式获取实例: - 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。 - 获取资产:取出资产包里已加载的 TiledMapAsset。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
tmxXmlText | TMX 文本 | 数据 | string | TMX XML 文本 地图 TMX 格式的 XML 字符串。 | - | 可选 |
tsxFiles | TSX 文件数组 | 数据 | cc.Asset / array / TextAsset | TSX 文件数组 地图引用的 TSX 图块集文件列表。 | - | 可选 |
tsxFileCount | TSX 文件数量 | 数据 | number | TSX 文件数量 tsxFiles 的元素数量。 | - | 可选 |
tsxFileNames | TSX 文件名数组 | 数据 | string / array | TSX 文件名数组 图块集文件名称列表。 | - | 可选 |
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 并行对应。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | tiledMapAssetGetSpriteFrameSizes |
| 分类 | 资产 |
| 二级分类 | 瓦片地图 |
| 分组 | TiledMapAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
tiledMapAsset | 地图资产 | 数据 | cc.Asset / TiledMapAsset | TiledMapAsset 地图资产 这里需要连接一个已经加载好的 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 并行对应。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | tiledMapAssetGetSpriteFrameNames |
| 分类 | 资产 |
| 二级分类 | 瓦片地图 |
| 分组 | TiledMapAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
tiledMapAsset | 地图资产 | 数据 | cc.Asset / TiledMapAsset | TiledMapAsset 地图资产 这里需要连接一个已经加载好的 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)的贴图。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | tiledMapAssetGetSpriteFrames |
| 分类 | 资产 |
| 二级分类 | 瓦片地图 |
| 分组 | TiledMapAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
tiledMapAsset | 地图资产 | 数据 | cc.Asset / TiledMapAsset | TiledMapAsset 地图资产 这里需要连接一个已经加载好的 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 并行对应。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | tiledMapAssetGetImageLayerSpriteFrameNames |
| 分类 | 资产 |
| 二级分类 | 瓦片地图 |
| 分组 | TiledMapAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
tiledMapAsset | 地图资产 | 数据 | cc.Asset / TiledMapAsset | TiledMapAsset 地图资产 这里需要连接一个已经加载好的 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。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | tiledMapAssetGetImageLayerSpriteFrames |
| 分类 | 资产 |
| 二级分类 | 瓦片地图 |
| 分组 | TiledMapAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
tiledMapAsset | 地图资产 | 数据 | cc.Asset / TiledMapAsset | TiledMapAsset 地图资产 这里需要连接一个已经加载好的 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。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | tiledMapAssetSetTmxXmlText |
| 分类 | 资产 |
| 二级分类 | 瓦片地图 |
| 分组 | TiledMapAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
tiledMapAsset | 地图资产 | 数据 | cc.Asset / TiledMapAsset | TiledMapAsset 地图资产 这里需要连接一个已经加载好的 TiledMapAsset 实例。 TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。 该端口没有”选择地图资产”按钮,请先使用以下方式获取实例: - 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。 - 获取资产:取出资产包里已加载的 TiledMapAsset。 | - | 必填 |
tmxXmlText | TMX 文本 | 数据 | string | TMX XML 文本 要写入的 TMX 格式 XML 字符串。不提供内联输入控件——请通过连线传入。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
tiledMapAsset | 地图资产 | 数据 | cc.Asset / TiledMapAsset | TiledMapAsset(透传) 把当前操作的 TiledMapAsset 实例原样传出,便于将多个配置节点串联在一起。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
设置 TSX 文件名数组
将 TSX 文件名字符串数组写入 TiledMapAsset。 注意:替换此数组时需保证与 tsxFiles 并行对应。 注意:修改 TiledMapAsset 字段不会自动刷新已挂载的 TiledMap 组件。若需让组件重新解析地图,请在后续通过组件分类节点显式重新设置 TiledMap.tmxAsset。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | tiledMapAssetSetTsxFileNames |
| 分类 | 资产 |
| 二级分类 | 瓦片地图 |
| 分组 | TiledMapAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
tiledMapAsset | 地图资产 | 数据 | cc.Asset / TiledMapAsset | TiledMapAsset 地图资产 这里需要连接一个已经加载好的 TiledMapAsset 实例。 TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。 该端口没有”选择地图资产”按钮,请先使用以下方式获取实例: - 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。 - 获取资产:取出资产包里已加载的 TiledMapAsset。 | - | 必填 |
tsxFileNames | TSX 文件名数组 | 数据 | string / array | TSX 文件名数组 要写入的图块集文件名数组,需与 tsxFiles 并行。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
tiledMapAsset | 地图资产 | 数据 | cc.Asset / TiledMapAsset | TiledMapAsset(透传) 把当前操作的 TiledMapAsset 实例原样传出,便于将多个配置节点串联在一起。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
设置 TSX 文件数组
将 TSX 文件数组(TextAsset[])写入 TiledMapAsset。 注意:替换此数组时需保证与 tsxFileNames 并行对应,否则地图解析会出错。 注意:修改 TiledMapAsset 字段不会自动刷新已挂载的 TiledMap 组件。若需让组件重新解析地图,请在后续通过组件分类节点显式重新设置 TiledMap.tmxAsset。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | tiledMapAssetSetTsxFiles |
| 分类 | 资产 |
| 二级分类 | 瓦片地图 |
| 分组 | TiledMapAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
tiledMapAsset | 地图资产 | 数据 | cc.Asset / TiledMapAsset | TiledMapAsset 地图资产 这里需要连接一个已经加载好的 TiledMapAsset 实例。 TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。 该端口没有”选择地图资产”按钮,请先使用以下方式获取实例: - 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。 - 获取资产:取出资产包里已加载的 TiledMapAsset。 | - | 必填 |
tsxFiles | TSX 文件数组 | 数据 | cc.Asset / array / TextAsset | TSX 文件数组 要写入的图块集文件数组,需与 tsxFileNames 并行。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
tiledMapAsset | 地图资产 | 数据 | cc.Asset / TiledMapAsset | TiledMapAsset(透传) 把当前操作的 TiledMapAsset 实例原样传出,便于将多个配置节点串联在一起。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
设置所有属性
一次性批量写入 TiledMapAsset 的多个可写字段。写入顺序:tmxXmlText → tsxFiles → tsxFileNames → spriteFrames → spriteFrameNames → spriteFrameSizes → imageLayerSpriteFrames → imageLayerSpriteFrameNames。 公开引脚语义(重要):除 exe 与 tiledMapAsset 外,所有可写属性引脚默认不公开(isPublic: false),只有被显式公开的引脚才参与写入。若想保留目标属性原值不变,必须保持引脚不公开——仅断开连线不够,已公开的引脚会用内联控件默认值覆盖原值。 注意:修改 TiledMapAsset 字段不会自动刷新已挂载的 TiledMap 组件。若需让组件重新解析地图,请在后续通过组件分类节点显式重新设置 TiledMap.tmxAsset。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | tiledMapAssetSetProperties |
| 分类 | 资产 |
| 二级分类 | 瓦片地图 |
| 分组 | TiledMapAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
tiledMapAsset | 地图资产 | 数据 | cc.Asset / TiledMapAsset | TiledMapAsset 地图资产 这里需要连接一个已经加载好的 TiledMapAsset 实例。 TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。 该端口没有”选择地图资产”按钮,请先使用以下方式获取实例: - 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。 - 获取资产:取出资产包里已加载的 TiledMapAsset。 | - | 必填 |
tmxXmlText | TMX 文本 | 数据 | string | TMX XML 文本 要写入的 TMX 文本。默认不公开;公开后才参与写入。 | - | 可选 默认隐藏 |
tsxFiles | TSX 文件数组 | 数据 | cc.Asset / array / TextAsset | TSX 文件数组 要写入的 TSX 文件列表。默认不公开;公开后才参与写入。 | - | 可选 默认隐藏 |
tsxFileNames | TSX 文件名数组 | 数据 | string / array | TSX 文件名数组 要写入的 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 / TiledMapAsset | TiledMapAsset(透传) 把当前操作的 TiledMapAsset 实例原样传出,便于将多个配置节点串联在一起。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
设置图块精灵帧尺寸数组
将图块尺寸数组写入 TiledMapAsset。 注意:替换此数组时需保证与 spriteFrames 和 spriteFrameNames 并行对应。 注意:修改 TiledMapAsset 字段不会自动刷新已挂载的 TiledMap 组件。若需让组件重新解析地图,请在后续通过组件分类节点显式重新设置 TiledMap.tmxAsset。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | tiledMapAssetSetSpriteFrameSizes |
| 分类 | 资产 |
| 二级分类 | 瓦片地图 |
| 分组 | TiledMapAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
tiledMapAsset | 地图资产 | 数据 | cc.Asset / TiledMapAsset | TiledMapAsset 地图资产 这里需要连接一个已经加载好的 TiledMapAsset 实例。 TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。 该端口没有”选择地图资产”按钮,请先使用以下方式获取实例: - 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。 - 获取资产:取出资产包里已加载的 TiledMapAsset。 | - | 必填 |
spriteFrameSizes | 图块精灵帧尺寸数组 | 数据 | size / array | 图块尺寸数组 要写入的图块尺寸列表,需与 spriteFrames / spriteFrameNames 并行。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
tiledMapAsset | 地图资产 | 数据 | cc.Asset / TiledMapAsset | TiledMapAsset(透传) 把当前操作的 TiledMapAsset 实例原样传出,便于将多个配置节点串联在一起。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
设置图块精灵帧名称数组
将图块名称字符串数组写入 TiledMapAsset。 注意:替换此数组时需保证与 spriteFrames 和 spriteFrameSizes 并行对应。 注意:修改 TiledMapAsset 字段不会自动刷新已挂载的 TiledMap 组件。若需让组件重新解析地图,请在后续通过组件分类节点显式重新设置 TiledMap.tmxAsset。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | tiledMapAssetSetSpriteFrameNames |
| 分类 | 资产 |
| 二级分类 | 瓦片地图 |
| 分组 | TiledMapAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
tiledMapAsset | 地图资产 | 数据 | cc.Asset / TiledMapAsset | TiledMapAsset 地图资产 这里需要连接一个已经加载好的 TiledMapAsset 实例。 TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。 该端口没有”选择地图资产”按钮,请先使用以下方式获取实例: - 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。 - 获取资产:取出资产包里已加载的 TiledMapAsset。 | - | 必填 |
spriteFrameNames | 图块精灵帧名称数组 | 数据 | string / array | 图块名称数组 要写入的图块名称列表,需与 spriteFrames / spriteFrameSizes 并行。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
tiledMapAsset | 地图资产 | 数据 | cc.Asset / TiledMapAsset | TiledMapAsset(透传) 把当前操作的 TiledMapAsset 实例原样传出,便于将多个配置节点串联在一起。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
设置图块精灵帧数组
将图块 SpriteFrame 数组写入 TiledMapAsset。 注意:替换此数组时需保证与 spriteFrameNames 和 spriteFrameSizes 并行对应。 注意:修改 TiledMapAsset 字段不会自动刷新已挂载的 TiledMap 组件。若需让组件重新解析地图,请在后续通过组件分类节点显式重新设置 TiledMap.tmxAsset。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | tiledMapAssetSetSpriteFrames |
| 分类 | 资产 |
| 二级分类 | 瓦片地图 |
| 分组 | TiledMapAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
tiledMapAsset | 地图资产 | 数据 | cc.Asset / TiledMapAsset | TiledMapAsset 地图资产 这里需要连接一个已经加载好的 TiledMapAsset 实例。 TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。 该端口没有”选择地图资产”按钮,请先使用以下方式获取实例: - 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。 - 获取资产:取出资产包里已加载的 TiledMapAsset。 | - | 必填 |
spriteFrames | 图块精灵帧数组 | 数据 | cc.Asset / array / SpriteFrame | 图块 SpriteFrame 数组 要写入的图块集贴图帧数组,需与 spriteFrameNames / spriteFrameSizes 并行。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
tiledMapAsset | 地图资产 | 数据 | cc.Asset / TiledMapAsset | TiledMapAsset(透传) 把当前操作的 TiledMapAsset 实例原样传出,便于将多个配置节点串联在一起。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
设置图片图层精灵帧名称数组
将图片图层名称字符串数组写入 TiledMapAsset。 注意:替换此数组时需保证与 imageLayerSpriteFrames 并行对应。 注意:修改 TiledMapAsset 字段不会自动刷新已挂载的 TiledMap 组件。若需让组件重新解析地图,请在后续通过组件分类节点显式重新设置 TiledMap.tmxAsset。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | tiledMapAssetSetImageLayerSpriteFrameNames |
| 分类 | 资产 |
| 二级分类 | 瓦片地图 |
| 分组 | TiledMapAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
tiledMapAsset | 地图资产 | 数据 | cc.Asset / TiledMapAsset | TiledMapAsset 地图资产 这里需要连接一个已经加载好的 TiledMapAsset 实例。 TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。 该端口没有”选择地图资产”按钮,请先使用以下方式获取实例: - 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。 - 获取资产:取出资产包里已加载的 TiledMapAsset。 | - | 必填 |
imageLayerSpriteFrameNames | 图片图层精灵帧名称数组 | 数据 | string / array | 图片图层名称数组 要写入的图片图层名称列表,需与 imageLayerSpriteFrames 并行。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
tiledMapAsset | 地图资产 | 数据 | cc.Asset / TiledMapAsset | TiledMapAsset(透传) 把当前操作的 TiledMapAsset 实例原样传出,便于将多个配置节点串联在一起。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
设置图片图层精灵帧数组
将图片图层 SpriteFrame 数组写入 TiledMapAsset。 注意:替换此数组时需保证与 imageLayerSpriteFrameNames 并行对应。 注意:修改 TiledMapAsset 字段不会自动刷新已挂载的 TiledMap 组件。若需让组件重新解析地图,请在后续通过组件分类节点显式重新设置 TiledMap.tmxAsset。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | tiledMapAssetSetImageLayerSpriteFrames |
| 分类 | 资产 |
| 二级分类 | 瓦片地图 |
| 分组 | TiledMapAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
tiledMapAsset | 地图资产 | 数据 | cc.Asset / TiledMapAsset | TiledMapAsset 地图资产 这里需要连接一个已经加载好的 TiledMapAsset 实例。 TiledMapAsset 是 TMX 文本 + TSX 依赖 + 图块 SpriteFrame 映射 + 图片图层 SpriteFrame 映射的组合资产。 该端口没有”选择地图资产”按钮,请先使用以下方式获取实例: - 加载资产:把”类型”选为 TILED_MAP_ASSET,从资产包按路径异步加载。 - 获取资产:取出资产包里已加载的 TiledMapAsset。 | - | 必填 |
imageLayerSpriteFrames | 图片图层精灵帧数组 | 数据 | cc.Asset / array / SpriteFrame | 图片图层 SpriteFrame 数组 要写入的图片图层贴图帧数组,需与 imageLayerSpriteFrameNames 并行。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
tiledMapAsset | 地图资产 | 数据 | cc.Asset / TiledMapAsset | TiledMapAsset(透传) 把当前操作的 TiledMapAsset 实例原样传出,便于将多个配置节点串联在一起。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。
新建地图资产
在游戏运行时创建一个全新的空 TiledMapAsset 实例,不含任何 TMX 文本、TSX 依赖或 SpriteFrame 映射数据。 需配合 设置 TMX 文本、设置 TSX 文件数组、设置图块精灵帧数组 等节点填充内容后才能被 TiledMap 组件正确解析。若只是加载已有地图资产,请改用 加载资产 节点(类型选 TILED_MAP_ASSET)。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | tiledMapAssetCreate |
| 分类 | 资产 |
| 二级分类 | 瓦片地图 |
| 分组 | TiledMapAsset |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
tiledMapAsset | 地图资产 | 数据 | cc.Asset / TiledMapAsset | TiledMapAsset 实例 新建的空地图资产实例。请继续连接 设置 TMX 文本、设置 TSX 文件数组、设置图块精灵帧数组 等节点为其填充内容。 | - | 可选 |
使用场景
- 读取音频时长、图片尺寸、材质参数等资产信息
- 校验加载结果是否可用
- 创建或传递特定类型的资产实例
注意事项
- 适合的工作流类型:component、library、method、function、class。
- 资产节点通常要求连接已加载的资产实例。
- 父类 Asset 生命周期能力应优先使用通用资产管理节点。