资产 / 场景 / SceneAsset节点

学习目标

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

覆盖范围

• 节点数量：3
• 分类路径：资产 / 场景 / SceneAsset

典型使用场景

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

通用注意事项

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

节点索引

节点	节点 ID	输入/输出	执行方式
获取场景	sceneAssetGetScene	1 / 1	立即继续
设置场景	sceneAssetSetScene	3 / 2	立即继续
校验场景资产	sceneAssetValidate	1 / 1	立即继续

获取场景

获取场景：从场景资产（cc.SceneAsset）中读出其包含的场景实例（cc.Scene）。 场景资产是 .scene 文件的游戏运行时包装——它本身不包含场景的具体内容（节点树、渲染配置等），这些都在 Scene 对象里。拿到 Scene 后，可以继续连接 场景查找 或 Cocos 节点/场景 系列节点来操作场景中的节点和全局配置。 如果场景资产尚未加载（scene 为 null），此端口输出空值。

节点信息

字段	值
节点 ID	sceneAssetGetScene
分类	资产
二级分类	场景
分组	SceneAsset
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
sceneAsset	场景资产	数据	cc.Asset / SceneAsset	SceneAsset 场景资产 这里需要连接一个已经加载好的 SceneAsset 实例。 该端口没有”选择场景资产”按钮，请先使用以下方式获取 SceneAsset 实例： - 加载场景：从资产包按路径异步加载场景文件，回调中会获得 SceneAsset。 - 获取资产：取出资产包里已加载的 SceneAsset。 - 加载资产：把”类型”选为 SCENE_ASSET，从资产包按路径异步加载。 本节点只负责读取场景信息，不会加载场景文件，也不会修改场景内容。	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
scene	场景	数据	cc.Node	场景 场景资产中包含的 Scene 游戏运行时对象。包含了场景的节点树、渲染配置、全局设置等全部内容。可连接到场景查找节点或 Scene 系列节点进一步操作。若场景资产尚未加载则为空。	-	可选

使用场景

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

注意事项

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

---

设置场景

设置场景：将一个 Scene 场景实例 绑定到场景资产上。 常见用途：在程序化构建场景后，将 Scene 对象挂载到一个新建或已有的 SceneAsset 上，以便后续通过资产系统管理或传递给其他需要 SceneAsset 的 API（如 Director.runScene）。 scene 端口不提供”选择场景”按钮，请先通过 获取场景 或 获取当前场景 拿到 Scene 实例，再连接到这里。 注意：设置场景后原 SceneAsset 中的旧场景引用会被替换，请确保旧场景已妥善处理。

节点信息

字段	值
节点 ID	sceneAssetSetScene
分类	资产
二级分类	场景
分组	SceneAsset
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口	-	可选
sceneAsset	场景资产	数据	cc.Asset / SceneAsset	SceneAsset 场景资产 这里需要连接一个已经加载好的 SceneAsset 实例。 该端口没有”选择场景资产”按钮，请先使用以下方式获取 SceneAsset 实例： - 加载场景：从资产包按路径异步加载场景文件，回调中会获得 SceneAsset。 - 获取资产：取出资产包里已加载的 SceneAsset。 - 加载资产：把”类型”选为 SCENE_ASSET，从资产包按路径异步加载。 本节点只负责读取场景信息，不会加载场景文件，也不会修改场景内容。	-	必填
scene	场景	数据	cc.Node	Scene 场景实例 这里需要连接一个 Scene（场景游戏运行时对象）。 该端口没有”选择场景”按钮，请先通过以下方式获取 Scene 实例： - 获取场景：从已加载的 SceneAsset 中读取其包含的 Scene 实例。 - 获取当前场景：获取引擎当前正在运行的场景。	-	必填

输出引脚

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

使用场景

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

注意事项

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

---

校验场景资产

校验场景资产：检查场景资产是否包含有效的场景数据（调用 validate() 方法）。 返回 true 表示场景资产的 scene 属性不为空，即已正确关联了一个 Scene 游戏运行时对象，可以安全地读取场景内容或传递给引擎 API。 返回 false 表示场景资产尚未绑定任何场景，通常发生在以下情况：场景文件正在加载中、加载失败或从未加载过该资产。 这是一个纯读取节点，不会修改场景资产状态。有头样式是因为引脚标签无法自证节点行为——用户需要标题才能区分这是”校验场景”而非”校验纹理”等其他资产的校验节点。

节点信息

字段	值
节点 ID	sceneAssetValidate
分类	资产
二级分类	场景
分组	SceneAsset
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
sceneAsset	场景资产	数据	cc.Asset / SceneAsset	SceneAsset 场景资产 这里需要连接一个已经加载好的 SceneAsset 实例。 该端口没有”选择场景资产”按钮，请先使用以下方式获取 SceneAsset 实例： - 加载场景：从资产包按路径异步加载场景文件，回调中会获得 SceneAsset。 - 获取资产：取出资产包里已加载的 SceneAsset。 - 加载资产：把”类型”选为 SCENE_ASSET，从资产包按路径异步加载。 本节点只负责读取场景信息，不会加载场景文件，也不会修改场景内容。	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
isValid	是否有效	数据	boolean	是否有效 true：场景资产已正确绑定 Scene 实例，可安全使用；false：场景资产尚未绑定任何场景数据（可能正在加载、加载失败或从未加载）。	-	可选

使用场景

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

注意事项

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