Script Graph

使用指南

资产 / 龙骨 / DragonBonesAtlasAsset节点

资产 / 龙骨 / DragonBonesAtlasAsset 节点手册,包含 11 个节点的用途、引脚、使用场景和注意事项。

16

学习目标

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

覆盖范围

  • 节点数量:11
  • 分类路径:资产 / 龙骨 / DragonBonesAtlasAsset

典型使用场景

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

通用注意事项

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

节点索引

节点节点 ID输入/输出执行方式
获取所有属性dragonBonesAtlasAssetGetProperties1 / 6立即继续
获取图集 JSONdragonBonesAtlasAssetGetAtlasJson1 / 1立即继续
获取图集名称dragonBonesAtlasAssetGetAtlasName1 / 1立即继续
获取图片路径dragonBonesAtlasAssetGetImagePath1 / 1立即继续
获取纹理dragonBonesAtlasAssetGetTexture1 / 1立即继续
获取子纹理名称列表dragonBonesAtlasAssetGetSubTextureNames1 / 1立即继续
获取子纹理数量dragonBonesAtlasAssetGetSubTextureCount1 / 1立即继续
判断子纹理是否存在dragonBonesAtlasAssetHasSubTexture2 / 1立即继续
设置图集 JSONdragonBonesAtlasAssetSetAtlasJson3 / 2立即继续
设置纹理dragonBonesAtlasAssetSetTexture3 / 2立即继续
新建龙骨图集dragonBonesAtlasAssetCreate1 / 2立即继续

获取所有属性

一次性读出龙骨图集的常用属性:图集 JSON、纹理、图集名称、图片路径、子纹理名称列表与数量。 等同于把多个单属性 获取类节点 串联,但只用一个节点即可。适合调试、快速概览等场景。

节点信息

字段
节点 IDdragonBonesAtlasAssetGetProperties
分类资产
二级分类龙骨
分组DragonBonesAtlasAsset
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
dragonBonesAtlasAsset龙骨图集数据cc.Asset / dragonBones.DragonBonesAtlasAsset龙骨图集
这里需要连接一个已经加载好的龙骨图集实例。
该端口没有”选择资产”按钮,请先使用以下方式获取实例:
- 加载资产:把”类型”选为 DRAGON_BONES_ATLAS_ASSET,从资产包按路径异步加载。
- 获取资产:取出资产包里已加载的龙骨图集。
- 新建龙骨图集:创建一个空实例,再通过 设置图集 JSON / 设置纹理 配置数据。
-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
atlasJson图集 JSON数据string图集 JSON
龙骨图集数据的完整 JSON 原文。
-可选
texture纹理数据cc.Asset / Texture2D纹理
图集当前绑定的底层纹理。
-可选
atlasName图集名称数据string图集名称
图集 JSON 中记录的名称。
-可选
imagePath图片路径数据string图片路径
图集 JSON 中记录的图片路径(元数据,不自动加载纹理)。
-可选
subTextureNames子纹理名称列表数据string / array子纹理名称列表
图集中全部子纹理的名称。
-可选
subTextureCount子纹理数量数据number子纹理数量
子纹理的数量。
-可选

使用场景

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

注意事项

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

获取图集 JSON

读出龙骨图集的图集 JSON 原文。 这是龙骨图集数据的完整 JSON,包含图集名称、图片路径与各子纹理定义。若资产尚未设置图集数据则输出空字符串。

节点信息

字段
节点 IDdragonBonesAtlasAssetGetAtlasJson
分类资产
二级分类龙骨
分组DragonBonesAtlasAsset
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
dragonBonesAtlasAsset龙骨图集数据cc.Asset / dragonBones.DragonBonesAtlasAsset龙骨图集
这里需要连接一个已经加载好的龙骨图集实例。
该端口没有”选择资产”按钮,请先使用以下方式获取实例:
- 加载资产:把”类型”选为 DRAGON_BONES_ATLAS_ASSET,从资产包按路径异步加载。
- 获取资产:取出资产包里已加载的龙骨图集。
- 新建龙骨图集:创建一个空实例,再通过 设置图集 JSON / 设置纹理 配置数据。
-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
atlasJson图集 JSON数据string图集 JSON
龙骨图集数据的完整 JSON 原文,包含图集名称、图片路径与各子纹理定义。
-可选

使用场景

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

注意事项

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

获取图集名称

从龙骨图集的 JSON 数据中提取图集名称。 为空表示 JSON 中未提供名称字段、图集数据尚未设置或解析失败。

节点信息

字段
节点 IDdragonBonesAtlasAssetGetAtlasName
分类资产
二级分类龙骨
分组DragonBonesAtlasAsset
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
dragonBonesAtlasAsset龙骨图集数据cc.Asset / dragonBones.DragonBonesAtlasAsset龙骨图集
这里需要连接一个已经加载好的龙骨图集实例。
该端口没有”选择资产”按钮,请先使用以下方式获取实例:
- 加载资产:把”类型”选为 DRAGON_BONES_ATLAS_ASSET,从资产包按路径异步加载。
- 获取资产:取出资产包里已加载的龙骨图集。
- 新建龙骨图集:创建一个空实例,再通过 设置图集 JSON / 设置纹理 配置数据。
-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
atlasName图集名称数据string图集名称
图集 JSON 中记录的名称。为空表示未提供或解析失败。
-可选

使用场景

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

注意事项

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

获取图片路径

从龙骨图集的 JSON 数据中提取图片路径。 注意:这只是图集元数据中记录的图片路径信息,不等于 asset-db 路径,也不会自动加载纹理。

节点信息

字段
节点 IDdragonBonesAtlasAssetGetImagePath
分类资产
二级分类龙骨
分组DragonBonesAtlasAsset
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
dragonBonesAtlasAsset龙骨图集数据cc.Asset / dragonBones.DragonBonesAtlasAsset龙骨图集
这里需要连接一个已经加载好的龙骨图集实例。
该端口没有”选择资产”按钮,请先使用以下方式获取实例:
- 加载资产:把”类型”选为 DRAGON_BONES_ATLAS_ASSET,从资产包按路径异步加载。
- 获取资产:取出资产包里已加载的龙骨图集。
- 新建龙骨图集:创建一个空实例,再通过 设置图集 JSON / 设置纹理 配置数据。
-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
imagePath图片路径数据string图片路径
图集 JSON 中记录的图片路径。这只是元数据信息,不等于项目资产路径,也不会自动加载纹理。
-可选

使用场景

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

注意事项

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

获取纹理

读出龙骨图集当前绑定的底层纹理。 返回的纹理可继续接到纹理系列节点读取宽高、过滤模式等属性。若尚未设置纹理则输出 null。

节点信息

字段
节点 IDdragonBonesAtlasAssetGetTexture
分类资产
二级分类龙骨
分组DragonBonesAtlasAsset
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
dragonBonesAtlasAsset龙骨图集数据cc.Asset / dragonBones.DragonBonesAtlasAsset龙骨图集
这里需要连接一个已经加载好的龙骨图集实例。
该端口没有”选择资产”按钮,请先使用以下方式获取实例:
- 加载资产:把”类型”选为 DRAGON_BONES_ATLAS_ASSET,从资产包按路径异步加载。
- 获取资产:取出资产包里已加载的龙骨图集。
- 新建龙骨图集:创建一个空实例,再通过 设置图集 JSON / 设置纹理 配置数据。
-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
texture纹理数据cc.Asset / Texture2D纹理
图集当前绑定的底层纹理。可连接到纹理系列节点读取宽高、过滤模式等。
-可选

使用场景

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

注意事项

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

获取子纹理名称列表

从龙骨图集的 JSON 数据中提取全部子纹理名称,以数组形式返回。 输出的是业务可读的名称列表,不输出内部子纹理原始对象。

节点信息

字段
节点 IDdragonBonesAtlasAssetGetSubTextureNames
分类资产
二级分类龙骨
分组DragonBonesAtlasAsset
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
dragonBonesAtlasAsset龙骨图集数据cc.Asset / dragonBones.DragonBonesAtlasAsset龙骨图集
这里需要连接一个已经加载好的龙骨图集实例。
该端口没有”选择资产”按钮,请先使用以下方式获取实例:
- 加载资产:把”类型”选为 DRAGON_BONES_ATLAS_ASSET,从资产包按路径异步加载。
- 获取资产:取出资产包里已加载的龙骨图集。
- 新建龙骨图集:创建一个空实例,再通过 设置图集 JSON / 设置纹理 配置数据。
-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
subTextureNames子纹理名称列表数据string / array子纹理名称列表
图集中全部子纹理的名称。图集为空或未设置时输出空数组。
-可选

使用场景

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

注意事项

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

获取子纹理数量

读出龙骨图集中包含的子纹理数量。 等效于”获取子纹理名称列表”输出的长度。图集为空或未设置时为 0。

节点信息

字段
节点 IDdragonBonesAtlasAssetGetSubTextureCount
分类资产
二级分类龙骨
分组DragonBonesAtlasAsset
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
dragonBonesAtlasAsset龙骨图集数据cc.Asset / dragonBones.DragonBonesAtlasAsset龙骨图集
这里需要连接一个已经加载好的龙骨图集实例。
该端口没有”选择资产”按钮,请先使用以下方式获取实例:
- 加载资产:把”类型”选为 DRAGON_BONES_ATLAS_ASSET,从资产包按路径异步加载。
- 获取资产:取出资产包里已加载的龙骨图集。
- 新建龙骨图集:创建一个空实例,再通过 设置图集 JSON / 设置纹理 配置数据。
-必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
subTextureCount子纹理数量数据number子纹理数量
图集中子纹理的总数;图集为空时为 0。
-可选

使用场景

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

注意事项

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

判断子纹理是否存在

判断龙骨图集中是否存在指定名称的子纹理。 名称区分大小写,建议优先通过获取子纹理名称列表获取可用名称后再传入。

节点信息

字段
节点 IDdragonBonesAtlasAssetHasSubTexture
分类资产
二级分类龙骨
分组DragonBonesAtlasAsset
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
dragonBonesAtlasAsset龙骨图集数据cc.Asset / dragonBones.DragonBonesAtlasAsset龙骨图集
这里需要连接一个已经加载好的龙骨图集实例。
该端口没有”选择资产”按钮,请先使用以下方式获取实例:
- 加载资产:把”类型”选为 DRAGON_BONES_ATLAS_ASSET,从资产包按路径异步加载。
- 获取资产:取出资产包里已加载的龙骨图集。
- 新建龙骨图集:创建一个空实例,再通过 设置图集 JSON / 设置纹理 配置数据。
-必填
subTextureName子纹理名称数据string子纹理名称
要查询的子纹理名称(区分大小写)。名称通常来自”获取子纹理名称列表”输出。
输入框
默认值:""
必填

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
exists是否存在数据boolean是否存在
true:指定名称的子纹理存在;false:不存在。可直接接条件分支节点。
-可选

使用场景

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

注意事项

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

设置图集 JSON

设置龙骨图集的图集 JSON 数据。 设置时引擎会自动解析 JSON 并重置内部缓存。请确保传入完整合法的龙骨图集 JSON 字符串,非法 JSON 会导致游戏运行时解析失败。 该端口不提供内联输入控件——图集 JSON 通常体积较大,请通过字符串变量、文本资产读取或上游转换节点提供内容。

节点信息

字段
节点 IDdragonBonesAtlasAssetSetAtlasJson
分类资产
二级分类龙骨
分组DragonBonesAtlasAsset
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
exe-执行流执行流执行入口-可选
dragonBonesAtlasAsset龙骨图集数据cc.Asset / dragonBones.DragonBonesAtlasAsset龙骨图集
这里需要连接一个已经加载好的龙骨图集实例。
该端口没有”选择资产”按钮,请先使用以下方式获取实例:
- 加载资产:把”类型”选为 DRAGON_BONES_ATLAS_ASSET,从资产包按路径异步加载。
- 获取资产:取出资产包里已加载的龙骨图集。
- 新建龙骨图集:创建一个空实例,再通过 设置图集 JSON / 设置纹理 配置数据。
-必填
atlasJson图集 JSON数据string图集 JSON
要设置的完整龙骨图集 JSON 字符串。必须是合法的 JSON,非法内容将导致游戏运行时解析失败。
-必填

输出引脚

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

使用场景

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

注意事项

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

设置纹理

设置龙骨图集绑定的底层纹理。 设置后引擎会重置内部缓存。该纹理应与图集 JSON 中的子纹理坐标匹配。 该端口不提供选择器,请连接已加载的纹理实例。

节点信息

字段
节点 IDdragonBonesAtlasAssetSetTexture
分类资产
二级分类龙骨
分组DragonBonesAtlasAsset
是否需要等待结果
是否需要先选择目标

输入引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
exe-执行流执行流执行入口-可选
dragonBonesAtlasAsset龙骨图集数据cc.Asset / dragonBones.DragonBonesAtlasAsset龙骨图集
这里需要连接一个已经加载好的龙骨图集实例。
该端口没有”选择资产”按钮,请先使用以下方式获取实例:
- 加载资产:把”类型”选为 DRAGON_BONES_ATLAS_ASSET,从资产包按路径异步加载。
- 获取资产:取出资产包里已加载的龙骨图集。
- 新建龙骨图集:创建一个空实例,再通过 设置图集 JSON / 设置纹理 配置数据。
-必填
texture纹理数据cc.Asset / Texture2D纹理
要绑定的纹理实例。请连接已加载的纹理,该纹理应与图集 JSON 中的子纹理坐标匹配。
-必填

输出引脚

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

使用场景

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

注意事项

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

新建龙骨图集

在游戏运行时创建一个全新的空龙骨图集实例,不包含任何图集数据。 需配合 设置图集 JSON 与 设置纹理 设置图集信息后才能正常使用。若只是加载已有资产,请改用 加载资产(类型选 DRAGON_BONES_ATLAS_ASSET)。

节点信息

字段
节点 IDdragonBonesAtlasAssetCreate
分类资产
二级分类龙骨
分组DragonBonesAtlasAsset
是否需要等待结果
是否需要先选择目标

输入引脚

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

输出引脚

引脚 ID名称连接方式值类型用途默认或选择连接要求
out-执行流执行流执行完成-可选
dragonBonesAtlasAsset龙骨图集数据cc.Asset / dragonBones.DragonBonesAtlasAsset龙骨图集实例
新建的空龙骨图集。连接到 设置图集 JSON / 设置纹理 节点为其配置图集数据。
-可选

使用场景

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

注意事项

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