使用指南
资产管理节点
资产管理 节点手册，包含 20 个节点的用途、引脚、使用场景和注意事项。
16
学习目标
通过资产包和资产路径加载游戏资源，并处理异步加载成功、失败和结果传递。
覆盖范围
- 节点数量：20
- 分类路径：资产管理
典型使用场景
- 按关卡加载 prefab、图片、音频或配置
- 在进入场景前预加载资产包
- 从已加载资产包中复用资源
通用注意事项
- 加载节点通常是异步节点，后续逻辑应从完成或成功出口继续。
- 路径、资产类型和 bundle 名称要与项目资源保持一致。
节点索引
| 节点 | 节点 ID | 输入/输出 | 执行方式 |
|---|---|---|---|
| 按请求加载资产 | loadAnyAsset | 4 / 8 | 需要等待结果 |
| 按请求预加载资产 | preloadAnyAsset | 4 / 7 | 需要等待结果 |
| 获取所有资产包 | getAllBundles | 0 / 1 | 立即继续 |
| 获取资产 | bundleGetAsset | 3 / 1 | 立即继续 |
| 获取资产包 | getBundle | 1 / 1 | 立即继续 |
| 加载场景资产 | bundleLoadScene | 3 / 8 | 需要等待结果 |
| 加载目录资产 | bundleLoadAssetDir | 4 / 8 | 需要等待结果 |
| 加载资产 | bundleLoadAsset | 4 / 8 | 需要等待结果 |
| 加载资产包 | loadBundle | 2 / 5 | 需要等待结果 |
| 清空全部缓存 | releaseAllAssets | 1 / 1 | 立即继续 |
| 清空资产包缓存 | bundleReleaseAllAsset | 2 / 1 | 立即继续 |
| 释放未使用缓存 | releaseUnusedAssets | 1 / 1 | 立即继续 |
| 释放未使用资产 | bundleReleaseUnusedAssets | 2 / 1 | 立即继续 |
| 释放资产 | releaseAsset | 2 / 1 | 立即继续 |
| 释放资产包资产 | bundleReleaseAsset | 4 / 1 | 立即继续 |
| 移除资产包 | removeBundle | 2 / 1 | 立即继续 |
| 预加载场景 | bundlePreloadScene | 3 / 7 | 需要等待结果 |
| 预加载目录资产 | bundlePreloadAssetDir | 4 / 7 | 需要等待结果 |
| 预加载资产 | bundlePreloadAsset | 4 / 7 | 需要等待结果 |
| 远程加载 | loadRemote | 3 / 5 | 需要等待结果 |
按请求加载资产
按请求加载资产：直接根据资产包和资产路径发起正式加载，不需要先拿到资产包对象。 适合在你已经确定目标资产属于哪个包、路径也已经明确时使用。它会返回真正可用的资产实例，后续可以直接连接到组件节点、实例化节点或其他资产处理节点。 如果你前面已经用按请求预加载资产提前下载过同一条请求，这里会复用预加载结果，加快正式加载完成速度。 注意：这里选择的资产路径必须属于左侧资产包；如果资产包和路径不匹配，加载会失败。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | loadAnyAsset |
| 分类 | 资产管理 |
| 二级分类 | - |
| 分组 | - |
| 是否需要等待结果 | 是 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | - | - | 可选 |
bundleUuid | 资产包 | 数据 | string | 资产包 选择资产所属的资产包。编译时会保存为资产包名称。 | 可编辑控件 默认值："" 可从项目内容中选择 | 必填 |
assetUuid | 资产路径 | 数据 | string | 资产路径 选择要加载的资产。它会编译成相对路径，因此必须与左侧资产包对应。 | 可编辑控件 默认值："" 可从项目内容中选择 | 必填 |
type | 类型 | 数据 | enum / AssetTypeEnum | 资产类型 可选。指定后会优先按这个类型解析同一路径下的资产。 | 可编辑控件 默认值：“ASSET” 可从项目内容中选择 | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 已发起 | 执行流 | 执行流 | 已发起 请求刚刚提交时触发，资产还在加载中。 | - | 可选 |
then | 成功 | 执行流 | 执行流 | 加载成功 正式加载完成并拿到可用资产实例时触发。 | - | 可选 |
asset | 资产 | 数据 | cc.Asset / Asset | 资产 正式加载完成后得到的可用资产实例。 | - | 可选 |
onError | 失败 | 执行流 | 执行流 | 加载失败 请求失败时触发，可从右侧错误引脚读取原因。 | - | 可选 |
error | 错误 | 数据 | string | 错误 正式加载失败时的错误信息。 | - | 可选 |
onProgress | 进度 | 执行流 | 执行流 | 进度 下载或解析进度更新时触发。 | - | 可选 |
finished | 已完成 | 数据 | number | 已完成数量 当前已经完成的请求项数量。 | - | 可选 |
total | 总数 | 数据 | number | 总数量 这次请求总共需要处理的请求项数量。 | - | 可选 |
使用场景
- 按关卡加载 prefab、图片、音频或配置
- 在进入场景前预加载资产包
- 从已加载资产包中复用资源
注意事项
- 这是异步节点，后续逻辑应从完成、成功或对应执行出口继续。
- 适合的工作流类型：component、library、method、function、class。
- 加载节点通常是异步节点，后续逻辑应从完成或成功出口继续。
- 路径、资产类型和 bundle 名称要与项目资源保持一致。
按请求预加载资产
按请求预加载资产：根据资产包和资产路径提前下载资产到缓存，但不会直接返回可用资产实例。 适合放在加载界面、关卡切换前或剧情播放前，先把后续会用到的资产下载好，等真正需要时再接按请求加载资产或其他正式加载节点。 预加载完成后，后续对同一条请求执行正式加载时可以复用已下载结果，减少等待时间。 注意：这里选择的资产路径必须属于左侧资产包；如果资产包和路径不匹配，预加载会失败。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | preloadAnyAsset |
| 分类 | 资产管理 |
| 二级分类 | - |
| 分组 | - |
| 是否需要等待结果 | 是 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | - | - | 可选 |
bundleUuid | 资产包 | 数据 | string | 资产包 选择资产所属的资产包。编译时会保存为资产包名称。 | 可编辑控件 默认值："" 可从项目内容中选择 | 必填 |
assetUuid | 资产路径 | 数据 | string | 资产路径 选择要预加载的资产。它会编译成相对路径，因此必须与左侧资产包对应。 | 可编辑控件 默认值："" 可从项目内容中选择 | 必填 |
type | 类型 | 数据 | enum / AssetTypeEnum | 资产类型 可选。指定后会优先按这个类型预下载同一路径下的资产。 | 可编辑控件 默认值：“ASSET” 可从项目内容中选择 | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 已发起 | 执行流 | 执行流 | 已发起 请求刚刚提交时触发，资产还在预下载中。 | - | 可选 |
then | 成功 | 执行流 | 执行流 | 预加载成功 下载完成并写入缓存后触发。 | - | 可选 |
onError | 失败 | 执行流 | 执行流 | 预加载失败 请求失败时触发，可从右侧错误引脚读取原因。 | - | 可选 |
error | 错误 | 数据 | string | 错误 预加载失败时的错误信息。 | - | 可选 |
onProgress | 进度 | 执行流 | 执行流 | 进度 下载进度更新时触发。 | - | 可选 |
finished | 已完成 | 数据 | number | 已完成数量 当前已经完成的预加载请求项数量。 | - | 可选 |
total | 总数 | 数据 | number | 总数量 这次预加载总共需要处理的请求项数量。 | - | 可选 |
使用场景
- 按关卡加载 prefab、图片、音频或配置
- 在进入场景前预加载资产包
- 从已加载资产包中复用资源
注意事项
- 这是异步节点，后续逻辑应从完成、成功或对应执行出口继续。
- 适合的工作流类型：component、library、method、function、class。
- 加载节点通常是异步节点，后续逻辑应从完成或成功出口继续。
- 路径、资产类型和 bundle 名称要与项目资源保持一致。
获取所有资产包
获取所有资产包：返回当前已加载的所有资产包列表。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | getAllBundles |
| 分类 | 资产管理 |
| 二级分类 | - |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
无。
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
bundles | 资产包列表 | 数据 | reference / array / AssetManager.Bundle | 资产包列表 所有已加载的资产包数组 | - | 可选 |
使用场景
- 按关卡加载 prefab、图片、音频或配置
- 在进入场景前预加载资产包
- 从已加载资产包中复用资源
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 加载节点通常是异步节点，后续逻辑应从完成或成功出口继续。
- 路径、资产类型和 bundle 名称要与项目资源保持一致。
获取资产
获取资产：从资产包中获取已加载的资产。 若资产未加载则返回 null。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | bundleGetAsset |
| 分类 | 资产管理 |
| 二级分类 | - |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
bundle | 资产包 | 数据 | reference / AssetManager.Bundle | 资产包引用 要从中获取资产的资产包 | - | 必填 |
assetUuid | 资产 | 数据 | string | 资产 选择要获取的资产 | 可编辑控件 默认值："" 可从项目内容中选择 | 必填 |
type | 类型 | 数据 | enum / AssetTypeEnum | 资产类型 可选，指定要获取的资产类型 | 可编辑控件 默认值：“ASSET” 可从项目内容中选择 | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
asset | 资产 | 数据 | cc.Asset / Asset | 资产引用 获取到的资产对象，未加载时为 null | - | 可选 |
使用场景
- 按关卡加载 prefab、图片、音频或配置
- 在进入场景前预加载资产包
- 从已加载资产包中复用资源
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 加载节点通常是异步节点，后续逻辑应从完成或成功出口继续。
- 路径、资产类型和 bundle 名称要与项目资源保持一致。
获取资产包
获取资产包：根据名称获取已加载的资产包。 若未加载则返回 null。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | getBundle |
| 分类 | 资产管理 |
| 二级分类 | - |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
bundleUuid | 资产包 | 数据 | string | 资产包 选择要获取的资产包（存储 UUID，编译期解析为名称） | 可编辑控件 默认值："" 可从项目内容中选择 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
bundle | 资产包 | 数据 | reference / AssetManager.Bundle | 资产包引用 获取到的资产包对象，未加载时为 null | - | 可选 |
使用场景
- 按关卡加载 prefab、图片、音频或配置
- 在进入场景前预加载资产包
- 从已加载资产包中复用资源
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 加载节点通常是异步节点，后续逻辑应从完成或成功出口继续。
- 路径、资产类型和 bundle 名称要与项目资源保持一致。
加载场景资产
加载场景资产：从指定资产包按场景名正式加载场景文件，并返回可直接用于切换场景的 SceneAsset（场景资产）。 适合在分包项目里先定位目标资产包，再把加载结果连接到运行场景资产这类导演节点，完成真正的切场。 如果前面已经对同名场景做过预加载，这里会复用预加载结果，通常能更快拿到 SceneAsset。 注意：场景名必须属于当前资产包；若场景不在这个包里，加载会失败。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | bundleLoadScene |
| 分类 | 资产管理 |
| 二级分类 | - |
| 分组 | - |
| 是否需要等待结果 | 是 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | - | - | 可选 |
bundle | 资产包 | 数据 | reference / AssetManager.Bundle | 资产包引用 要从中加载场景的资产包对象。 | - | 必填 |
sceneName | 场景名 | 数据 | string | 场景名 选择要加载的场景。它必须属于左侧资产包。 | 可编辑控件 默认值："" 可从项目内容中选择 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 已发起 | 执行流 | 执行流 | 已发起 场景加载请求刚刚发出时触发。 | - | 可选 |
then | 成功 | 执行流 | 执行流 | 加载成功 成功拿到 SceneAsset 时触发。 | - | 可选 |
sceneAsset | 场景资产 | 数据 | cc.Asset / SceneAsset | 场景资产 加载完成得到的 SceneAsset，可继续连接到运行场景资产等节点。 | - | 可选 |
onError | 失败 | 执行流 | 执行流 | 加载失败 请求失败时触发，可从右侧错误引脚读取原因。 | - | 可选 |
error | 错误 | 数据 | string | 错误 场景加载失败时的错误信息。 | - | 可选 |
onProgress | 进度 | 执行流 | 执行流 | 进度 场景资产加载进度更新时触发。 | - | 可选 |
finished | 已完成 | 数据 | number | 已完成数量 当前已经完成的场景加载请求项数量。 | - | 可选 |
total | 总数 | 数据 | number | 总数量 这次场景加载总共需要处理的请求项数量。 | - | 可选 |
使用场景
- 按关卡加载 prefab、图片、音频或配置
- 在进入场景前预加载资产包
- 从已加载资产包中复用资源
注意事项
- 这是异步节点，后续逻辑应从完成、成功或对应执行出口继续。
- 适合的工作流类型：component、library、method、function、class。
- 加载节点通常是异步节点，后续逻辑应从完成或成功出口继续。
- 路径、资产类型和 bundle 名称要与项目资源保持一致。
加载目录资产
加载目录资产：加载资产包中指定目录下的所有资产。 可指定资产类型进行过滤。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | bundleLoadAssetDir |
| 分类 | 资产管理 |
| 二级分类 | - |
| 分组 | - |
| 是否需要等待结果 | 是 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | - | - | 可选 |
bundle | 资产包 | 数据 | reference / AssetManager.Bundle | 资产包引用 要从中加载资产的资产包 | - | 必填 |
dirUuid | 目录 | 数据 | string | 目录 选择要加载的目录 | 可编辑控件 默认值："" 可从项目内容中选择 | 必填 |
type | 类型 | 数据 | enum / AssetTypeEnum | 资产类型 可选，指定要加载的资产类型 | 可编辑控件 默认值：“ASSET” 可从项目内容中选择 | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 已发起 | 执行流 | 执行流 | 已发起 目录资产加载请求刚刚发出时触发。 | - | 可选 |
then | 成功 | 执行流 | 执行流 | 加载成功 目录资产加载完成时触发。 | - | 可选 |
assets | 资产列表 | 数据 | cc.Asset / array / Asset | 资产数组 加载成功后的资产对象数组 | - | 可选 |
onError | 失败 | 执行流 | 执行流 | 加载失败 加载出错时触发。 | - | 可选 |
error | 错误 | 数据 | string | 错误信息 加载失败的错误描述 | - | 可选 |
onProgress | 进度 | 执行流 | 执行流 | 进度 加载进度更新时触发。 | - | 可选 |
finished | 已完成 | 数据 | number | 已完成数量 当前已加载的资产数 | - | 可选 |
total | 总数 | 数据 | number | 总数量 需要加载的资产总数 | - | 可选 |
使用场景
- 按关卡加载 prefab、图片、音频或配置
- 在进入场景前预加载资产包
- 从已加载资产包中复用资源
注意事项
- 这是异步节点，后续逻辑应从完成、成功或对应执行出口继续。
- 适合的工作流类型：component、library、method、function、class。
- 加载节点通常是异步节点，后续逻辑应从完成或成功出口继续。
- 路径、资产类型和 bundle 名称要与项目资源保持一致。
加载资产
加载资产：从指定资产包异步加载资产。 支持单个或多个路径，可指定资产类型。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | bundleLoadAsset |
| 分类 | 资产管理 |
| 二级分类 | - |
| 分组 | - |
| 是否需要等待结果 | 是 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | - | - | 可选 |
bundle | 资产包 | 数据 | reference / AssetManager.Bundle | 资产包引用 要从中加载资产的资产包 | - | 必填 |
assetUuid | 资产 | 数据 | string | 资产 选择要加载的资产 | 可编辑控件 默认值："" 可从项目内容中选择 | 必填 |
type | 类型 | 数据 | enum / AssetTypeEnum | 资产类型 可选，指定要加载的资产类型 | 可编辑控件 默认值：“ASSET” 可从项目内容中选择 | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 已发起 | 执行流 | 执行流 | 已发起 资产加载请求刚刚发出时触发。 | - | 可选 |
then | 成功 | 执行流 | 执行流 | 加载成功 资产加载完成时触发。 | - | 可选 |
asset | 资产 | 数据 | cc.Asset / Asset | 资产引用 加载成功后的资产对象（单个或数组） | - | 可选 |
onError | 失败 | 执行流 | 执行流 | 加载失败 加载出错时触发。 | - | 可选 |
error | 错误 | 数据 | string | 错误信息 加载失败的错误描述 | - | 可选 |
onProgress | 进度 | 执行流 | 执行流 | 进度 加载进度更新时触发。 | - | 可选 |
finished | 已完成 | 数据 | number | 已完成数量 当前已加载的资产数 | - | 可选 |
total | 总数 | 数据 | number | 总数量 需要加载的资产总数 | - | 可选 |
使用场景
- 按关卡加载 prefab、图片、音频或配置
- 在进入场景前预加载资产包
- 从已加载资产包中复用资源
注意事项
- 这是异步节点，后续逻辑应从完成、成功或对应执行出口继续。
- 适合的工作流类型：component、library、method、function、class。
- 加载节点通常是异步节点，后续逻辑应从完成或成功出口继续。
- 路径、资产类型和 bundle 名称要与项目资源保持一致。
加载资产包
加载资产包：根据名称或 URL 异步加载资产包。 成功后输出资产包引用，失败输出错误信息。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | loadBundle |
| 分类 | 资产管理 |
| 二级分类 | - |
| 分组 | - |
| 是否需要等待结果 | 是 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | - | - | 可选 |
bundleUuid | 资产包 | 数据 | string | 资产包 选择要加载的资产包（存储 UUID，编译期解析为名称） | 可编辑控件 默认值："" 可从项目内容中选择 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 已发起 | 执行流 | 执行流 | 已发起 资产包加载请求刚刚发出时触发。 | - | 可选 |
then | 成功 | 执行流 | 执行流 | 加载成功 资产包加载完成时触发。 | - | 可选 |
bundle | 资产包 | 数据 | reference / AssetManager.Bundle | 资产包引用 加载成功后的资产包对象 | - | 可选 |
onError | 失败 | 执行流 | 执行流 | 加载失败 加载出错时触发。 | - | 可选 |
error | 错误 | 数据 | string | 错误信息 加载失败的错误描述 | - | 可选 |
使用场景
- 按关卡加载 prefab、图片、音频或配置
- 在进入场景前预加载资产包
- 从已加载资产包中复用资源
注意事项
- 这是异步节点，后续逻辑应从完成、成功或对应执行出口继续。
- 适合的工作流类型：component、library、method、function、class。
- 加载节点通常是异步节点，后续逻辑应从完成或成功出口继续。
- 路径、资产类型和 bundle 名称要与项目资源保持一致。
清空全部缓存
清空全部缓存：释放当前资产系统中的全部已加载资产。 只适合在你明确知道接下来会重新建立资产状态时使用，例如彻底退出游戏流程、重建运行环境，或主动做一次完整的资产重置。 注意：这是高风险操作。执行后，后续任何仍需使用的资产都必须重新加载；如果场景里还有对象依赖这些资产，画面或表现可能立刻出现异常。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | releaseAllAssets |
| 分类 | 资产管理 |
| 二级分类 | - |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | - | - | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 全部缓存清理结束后触发。 | - | 可选 |
使用场景
- 按关卡加载 prefab、图片、音频或配置
- 在进入场景前预加载资产包
- 从已加载资产包中复用资源
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 加载节点通常是异步节点，后续逻辑应从完成或成功出口继续。
- 路径、资产类型和 bundle 名称要与项目资源保持一致。
清空资产包缓存
清空资产包缓存：释放当前资产包中的全部已加载资产。 适合在你确认这个资产包短时间内不会再被使用时，彻底回收它占用的缓存。 注意：这是高风险操作。清空后，后续如果还要继续使用这个包里的任何资产，都需要重新加载；如果仍有对象依赖这些资产，画面或表现可能出现贴图丢失等问题。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | bundleReleaseAllAsset |
| 分类 | 资产管理 |
| 二级分类 | - |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | - | - | 可选 |
bundle | 资产包 | 数据 | reference / AssetManager.Bundle | 资产包引用 要释放所有资产的资产包 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 缓存清空完成后从此处继续执行下游逻辑 | - | 可选 |
使用场景
- 按关卡加载 prefab、图片、音频或配置
- 在进入场景前预加载资产包
- 从已加载资产包中复用资源
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 加载节点通常是异步节点，后续逻辑应从完成或成功出口继续。
- 路径、资产类型和 bundle 名称要与项目资源保持一致。
释放未使用缓存
释放未使用缓存：让资产系统回收当前没有被使用的缓存资产。 适合在大场景退场、模块关闭、战斗结算后统一做一次内存整理，保留仍在使用的资产，回收已经闲置的缓存。 注意：被回收的资产如果稍后还要继续使用，需要重新加载。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | releaseUnusedAssets |
| 分类 | 资产管理 |
| 二级分类 | - |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | - | - | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 未使用缓存回收结束后触发。 | - | 可选 |
使用场景
- 按关卡加载 prefab、图片、音频或配置
- 在进入场景前预加载资产包
- 从已加载资产包中复用资源
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 加载节点通常是异步节点，后续逻辑应从完成或成功出口继续。
- 路径、资产类型和 bundle 名称要与项目资源保持一致。
释放未使用资产
释放未使用资产：回收当前资产包里暂时没有被使用的缓存资产。 适合在关卡切换、UI 页面关闭、剧情段落结束后，把这个包里已经闲置的资产释放掉，降低内存占用。 注意：被回收的资产如果后面还要继续用，需要重新加载。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | bundleReleaseUnusedAssets |
| 分类 | 资产管理 |
| 二级分类 | - |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | - | - | 可选 |
bundle | 资产包 | 数据 | reference / AssetManager.Bundle | 资产包引用 要回收未使用缓存资产的资产包。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 未使用资产回收操作结束后触发。 | - | 可选 |
使用场景
- 按关卡加载 prefab、图片、音频或配置
- 在进入场景前预加载资产包
- 从已加载资产包中复用资源
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 加载节点通常是异步节点，后续逻辑应从完成或成功出口继续。
- 路径、资产类型和 bundle 名称要与项目资源保持一致。
释放资产
释放资产：释放单个已加载的资产，释放后资产将从内存中移除。 适合在不再需要某个特定资产时使用，例如替换角色模型、清理过期的界面资产等场景。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | releaseAsset |
| 分类 | 资产管理 |
| 二级分类 | - |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | - | - | 可选 |
asset | 资产 | 数据 | cc.Asset / Asset | 资产引用 要释放的资产对象 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 资产释放完成后从此处继续执行下游逻辑 | - | 可选 |
使用场景
- 按关卡加载 prefab、图片、音频或配置
- 在进入场景前预加载资产包
- 从已加载资产包中复用资源
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 加载节点通常是异步节点，后续逻辑应从完成或成功出口继续。
- 路径、资产类型和 bundle 名称要与项目资源保持一致。
释放资产包资产
释放资产包资产：按路径释放这个资产包里已经加载过的单个资产。 释放后，这个资产及其依赖缓存可能被回收；如果后续还要继续使用，需要重新加载。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | bundleReleaseAsset |
| 分类 | 资产管理 |
| 二级分类 | - |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | - | - | 可选 |
bundle | 资产包 | 数据 | reference / AssetManager.Bundle | 资产包引用 要释放资产的资产包 | - | 必填 |
assetUuid | 资产 | 数据 | string | 资产 选择要释放的资产 | 可编辑控件 默认值："" 可从项目内容中选择 | 必填 |
type | 类型 | 数据 | enum / AssetTypeEnum | 资产类型 可选，指定要释放的资产类型 | 可编辑控件 默认值：“ASSET” 可从项目内容中选择 | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | - | - | 可选 |
使用场景
- 按关卡加载 prefab、图片、音频或配置
- 在进入场景前预加载资产包
- 从已加载资产包中复用资源
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 加载节点通常是异步节点，后续逻辑应从完成或成功出口继续。
- 路径、资产类型和 bundle 名称要与项目资源保持一致。
移除资产包
移除资产包：从内存中移除指定的资产包，移除后该资产包的资产将不可用。 适合在场景切换或关卡退出时释放不再需要的资产包，减少内存占用。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | removeBundle |
| 分类 | 资产管理 |
| 二级分类 | - |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 连接到此端口以执行移除资产包操作 | - | 可选 |
bundle | 资产包 | 数据 | reference / AssetManager.Bundle | 资产包引用 要移除的资产包对象 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 资产包移除完成后从此处继续执行下游逻辑 | - | 可选 |
使用场景
- 按关卡加载 prefab、图片、音频或配置
- 在进入场景前预加载资产包
- 从已加载资产包中复用资源
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 加载节点通常是异步节点，后续逻辑应从完成或成功出口继续。
- 路径、资产类型和 bundle 名称要与项目资源保持一致。
预加载场景
预加载场景：提前下载指定场景依赖的资产到缓存，但不会直接切换场景，也不会返回可用的 SceneAsset。 适合在加载界面或过场动画期间，把下一个场景先准备好。等预加载完成后，再调用加载场景资产或导演侧场景切换节点完成真正的进入。 注意：场景名必须属于当前资产包；若场景不在这个包里，预加载会失败。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | bundlePreloadScene |
| 分类 | 资产管理 |
| 二级分类 | - |
| 分组 | - |
| 是否需要等待结果 | 是 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | - | - | 可选 |
bundle | 资产包 | 数据 | reference / AssetManager.Bundle | 资产包引用 要从中预加载场景的资产包对象。 | - | 必填 |
sceneName | 场景名 | 数据 | string | 场景名 选择要预加载的场景。它必须属于左侧资产包。 | 可编辑控件 默认值："" 可从项目内容中选择 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 已发起 | 执行流 | 执行流 | 已发起 场景预加载请求刚刚发出时触发。 | - | 可选 |
then | 成功 | 执行流 | 执行流 | 预加载成功 场景依赖资产进入缓存后触发。 | - | 可选 |
onError | 失败 | 执行流 | 执行流 | 预加载失败 请求失败时触发，可从右侧错误引脚读取原因。 | - | 可选 |
error | 错误 | 数据 | string | 错误 场景预加载失败时的错误信息。 | - | 可选 |
onProgress | 进度 | 执行流 | 执行流 | 进度 场景资产预加载进度更新时触发。 | - | 可选 |
finished | 已完成 | 数据 | number | 已完成数量 当前已经完成的场景预加载请求项数量。 | - | 可选 |
total | 总数 | 数据 | number | 总数量 这次场景预加载总共需要处理的请求项数量。 | - | 可选 |
使用场景
- 按关卡加载 prefab、图片、音频或配置
- 在进入场景前预加载资产包
- 从已加载资产包中复用资源
注意事项
- 这是异步节点，后续逻辑应从完成、成功或对应执行出口继续。
- 适合的工作流类型：component、library、method、function、class。
- 加载节点通常是异步节点，后续逻辑应从完成或成功出口继续。
- 路径、资产类型和 bundle 名称要与项目资源保持一致。
预加载目录资产
预加载目录资产：预加载资产包中指定目录下的所有资产到缓存。 可指定资产类型进行过滤。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | bundlePreloadAssetDir |
| 分类 | 资产管理 |
| 二级分类 | - |
| 分组 | - |
| 是否需要等待结果 | 是 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | - | - | 可选 |
bundle | 资产包 | 数据 | reference / AssetManager.Bundle | 资产包引用 要从中预加载资产的资产包 | - | 必填 |
dirUuid | 目录 | 数据 | string | 目录 选择要预加载的目录 | 可编辑控件 默认值："" 可从项目内容中选择 | 必填 |
type | 类型 | 数据 | enum / AssetTypeEnum | 资产类型 可选，指定要预加载的资产类型 | 可编辑控件 默认值：“ASSET” 可从项目内容中选择 | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 已发起 | 执行流 | 执行流 | 已发起 目录资产预加载请求刚刚发出时触发。 | - | 可选 |
then | 成功 | 执行流 | 执行流 | 预加载成功 目录资产预加载完成时触发。 | - | 可选 |
onError | 失败 | 执行流 | 执行流 | 预加载失败 预加载出错时触发。 | - | 可选 |
error | 错误 | 数据 | string | 错误信息 预加载失败的错误描述 | - | 可选 |
onProgress | 进度 | 执行流 | 执行流 | 进度 预加载进度更新时触发。 | - | 可选 |
finished | 已完成 | 数据 | number | 已完成数量 当前已预加载的资产数 | - | 可选 |
total | 总数 | 数据 | number | 总数量 需要预加载的资产总数 | - | 可选 |
使用场景
- 按关卡加载 prefab、图片、音频或配置
- 在进入场景前预加载资产包
- 从已加载资产包中复用资源
注意事项
- 这是异步节点，后续逻辑应从完成、成功或对应执行出口继续。
- 适合的工作流类型：component、library、method、function、class。
- 加载节点通常是异步节点，后续逻辑应从完成或成功出口继续。
- 路径、资产类型和 bundle 名称要与项目资源保持一致。
预加载资产
预加载资产：预加载资产到缓存，不立即实例化。 适用于提前加载后续需要的资产。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | bundlePreloadAsset |
| 分类 | 资产管理 |
| 二级分类 | - |
| 分组 | - |
| 是否需要等待结果 | 是 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | - | - | 可选 |
bundle | 资产包 | 数据 | reference / AssetManager.Bundle | 资产包引用 要从中预加载资产的资产包 | - | 必填 |
assetUuid | 资产 | 数据 | string | 资产 选择要加载的资产 | 可编辑控件 默认值："" 可从项目内容中选择 | 必填 |
type | 类型 | 数据 | enum / AssetTypeEnum | 资产类型 可选，指定要预加载的资产类型 | 可编辑控件 默认值：“ASSET” 可从项目内容中选择 | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 已发起 | 执行流 | 执行流 | 已发起 资产预加载请求刚刚发出时触发。 | - | 可选 |
then | 成功 | 执行流 | 执行流 | 预加载成功 预加载完成时触发。 | - | 可选 |
onError | 失败 | 执行流 | 执行流 | 预加载失败 预加载出错时触发。 | - | 可选 |
error | 错误 | 数据 | string | 错误信息 预加载失败的错误描述 | - | 可选 |
onProgress | 进度 | 执行流 | 执行流 | 进度 预加载进度更新时触发。 | - | 可选 |
finished | 已完成 | 数据 | number | 已完成数量 当前已预加载的资产数 | - | 可选 |
total | 总数 | 数据 | number | 总数量 需要预加载的资产总数 | - | 可选 |
使用场景
- 按关卡加载 prefab、图片、音频或配置
- 在进入场景前预加载资产包
- 从已加载资产包中复用资源
注意事项
- 这是异步节点，后续逻辑应从完成、成功或对应执行出口继续。
- 适合的工作流类型：component、library、method、function、class。
- 加载节点通常是异步节点，后续逻辑应从完成或成功出口继续。
- 路径、资产类型和 bundle 名称要与项目资源保持一致。
远程加载
远程加载：从远程 URL 异步加载资产。 适用于加载网络上的图片、音频等资产。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | loadRemote |
| 分类 | 资产管理 |
| 二级分类 | - |
| 分组 | - |
| 是否需要等待结果 | 是 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | - | - | 可选 |
url | URL | 数据 | string | 远程 URL 要加载的资产网络地址 | 输入框 默认值："" | 必填 |
type | 类型 | 数据 | enum / AssetTypeEnum | 资产类型 可选，指定要加载的资产类型 | 可编辑控件 默认值：“ASSET” 可从项目内容中选择 | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | 已发起 | 执行流 | 执行流 | 已发起 远程加载请求刚刚发出时触发。 | - | 可选 |
then | 成功 | 执行流 | 执行流 | 加载成功 远程资产加载完成时触发。 | - | 可选 |
asset | 资产 | 数据 | cc.Asset / Asset | 资产引用 加载成功后的资产对象 | - | 可选 |
onError | 失败 | 执行流 | 执行流 | 加载失败 加载出错时触发。 | - | 可选 |
error | 错误 | 数据 | string | 错误信息 加载失败的错误描述 | - | 可选 |
使用场景
- 按关卡加载 prefab、图片、音频或配置
- 在进入场景前预加载资产包
- 从已加载资产包中复用资源
注意事项
- 这是异步节点，后续逻辑应从完成、成功或对应执行出口继续。
- 适合的工作流类型：component、library、method、function、class。
- 加载节点通常是异步节点，后续逻辑应从完成或成功出口继续。
- 路径、资产类型和 bundle 名称要与项目资源保持一致。