使用指南
Cocos 节点 / 场景节点
Cocos 节点 / 场景 节点手册，包含 20 个节点的用途、引脚、使用场景和注意事项。
16
学习目标
操作场景中的 Node 对象，包括层级、变换、组件、激活状态和场景查找。
覆盖范围
- 节点数量：20
- 分类路径：Cocos 节点 / 场景
典型使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
通用注意事项
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
节点索引
| 节点 | 节点 ID | 输入/输出 | 执行方式 |
|---|---|---|---|
| 获取八叉树配置 | sceneGetOctree | 1 / 1 | 立即继续 |
| 获取场景常用属性 | sceneGetProperties | 1 / 15 | 立即继续 |
| 获取场景全局配置 | sceneGetGlobals | 1 / 1 | 立即继续 |
| 获取当前场景 | sceneGetCurrent | 0 / 1 | 立即继续 |
| 获取高精度光照图开关 | sceneGetBakedWithHighpLightmap | 1 / 1 | 立即继续 |
| 获取关闭光照图开关 | sceneGetDisableLightmap | 1 / 1 | 立即继续 |
| 获取光照探针配置 | sceneGetLightProbeInfo | 1 / 1 | 立即继续 |
| 获取后处理配置 | sceneGetPostSettings | 1 / 1 | 立即继续 |
| 获取环境光配置 | sceneGetAmbient | 1 / 1 | 立即继续 |
| 获取静止主光烘焙开关 | sceneGetBakedWithStationaryMainLight | 1 / 1 | 立即继续 |
| 获取皮肤后处理配置 | sceneGetSkin | 1 / 1 | 立即继续 |
| 获取天空盒配置 | sceneGetSkybox | 1 / 1 | 立即继续 |
| 获取雾效配置 | sceneGetFog | 1 / 1 | 立即继续 |
| 获取渲染层场景 | sceneGetRenderScene | 1 / 1 | 立即继续 |
| 获取阴影配置 | sceneGetShadows | 1 / 1 | 立即继续 |
| 获取自动释放资产 | sceneGetAutoReleaseAssets | 1 / 1 | 立即继续 |
| 设置高精度光照图开关 | sceneSetBakedWithHighpLightmap | 3 / 2 | 立即继续 |
| 设置关闭光照图开关 | sceneSetDisableLightmap | 3 / 2 | 立即继续 |
| 设置静止主光烘焙开关 | sceneSetBakedWithStationaryMainLight | 3 / 2 | 立即继续 |
| 设置自动释放资产 | sceneSetAutoReleaseAssets | 3 / 2 | 立即继续 |
获取八叉树配置
获取八叉树配置：返回 Scene.globals.octree。 可继续读取裁剪开关、世界包围盒范围和树深度。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sceneGetOctree |
| 分类 | Cocos 节点 |
| 二级分类 | 场景 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scene | 场景 | 数据 | cc.Node / Scene | 目标场景 要读取或修改的 Scene 对象。 通常来自“获取当前场景”，或其它返回 Scene 的节点。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
octree | 八叉树配置 | 数据 | reference / OctreeInfo | 八叉树配置 OctreeInfo 对象。 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
获取场景常用属性
获取场景常用属性：一次性读取 Scene 的高频场景级信息。 适合在调试、初始化或配置同步时，集中获取自动释放资产、渲染层场景、SceneGlobals 以及各类场景级渲染配置对象。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sceneGetProperties |
| 分类 | Cocos 节点 |
| 二级分类 | 场景 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scene | 场景 | 数据 | cc.Node / Scene | 目标场景 要读取或修改的 Scene 对象。 通常来自“获取当前场景”，或其它返回 Scene 的节点。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scene | 场景 | 数据 | cc.Node / Scene | 场景对象 当前操作的 Scene，便于继续链式读取其它场景信息。 | - | 可选 |
autoReleaseAssets | 自动释放资产 | 数据 | boolean | 自动释放资产开关 Scene.autoReleaseAssets 当前值。 | - | 可选 |
renderScene | 渲染层场景 | 数据 | reference / renderer.RenderScene | 渲染层场景 renderer.RenderScene 只读渲染层对象。 | - | 可选 |
globals | 全局配置 | 数据 | reference / SceneGlobals | 场景全局配置 SceneGlobals 对象。 | - | 可选 |
ambient | 环境光配置 | 数据 | reference / AmbientInfo | 环境光配置 AmbientInfo 对象。 | - | 可选 |
shadows | 阴影配置 | 数据 | reference / ShadowsInfo | 阴影配置 ShadowsInfo 对象。 | - | 可选 |
fog | 雾效配置 | 数据 | reference / FogInfo | 雾效配置 FogInfo 对象。 | - | 可选 |
skybox | 天空盒配置 | 数据 | reference / SkyboxInfo | 天空盒配置 SkyboxInfo 对象。 | - | 可选 |
octree | 八叉树配置 | 数据 | reference / OctreeInfo | 八叉树配置 OctreeInfo 对象。 | - | 可选 |
skin | 皮肤配置 | 数据 | reference / SkinInfo | 皮肤配置 SkinInfo 对象。 | - | 可选 |
lightProbeInfo | 光照探针配置 | 数据 | reference / LightProbeInfo | 光照探针配置 LightProbeInfo 对象。 | - | 可选 |
postSettings | 后处理配置 | 数据 | reference / PostSettingsInfo | 后处理配置 PostSettingsInfo 对象。 | - | 可选 |
bakedWithStationaryMainLight | 静止主光烘焙 | 数据 | boolean | 静止主光烘焙开关 SceneGlobals.bakedWithStationaryMainLight 当前值。 | - | 可选 |
bakedWithHighpLightmap | 高精度光照图 | 数据 | boolean | 高精度光照图开关 SceneGlobals.bakedWithHighpLightmap 当前值。 | - | 可选 |
disableLightmap | 关闭光照图 | 数据 | boolean | 关闭光照图开关 SceneGlobals.disableLightmap 当前值。 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
获取场景全局配置
获取场景全局配置：返回 Scene.globals。 它统一管理环境光、阴影、雾、天空盒、八叉树、光照探针和色调映射等场景级渲染设置。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sceneGetGlobals |
| 分类 | Cocos 节点 |
| 二级分类 | 场景 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scene | 场景 | 数据 | cc.Node / Scene | 目标场景 要读取或修改的 Scene 对象。 通常来自“获取当前场景”，或其它返回 Scene 的节点。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
globals | 全局配置 | 数据 | reference / SceneGlobals | 场景全局配置 SceneGlobals 对象，持有所有场景级渲染设置。 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
获取当前场景
获取当前运行场景：返回 Director 当前正在管理的 Scene 对象。 适合从场景级全局配置开始读取，例如自动释放资产、天空盒、雾效、光照探针和后处理设置。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sceneGetCurrent |
| 分类 | Cocos 节点 |
| 二级分类 | 场景 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
无。
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scene | 场景 | 数据 | cc.Node / Scene | 场景对象 当前操作的 Scene，便于继续链式读取其它场景信息。 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
获取高精度光照图开关
获取高精度光照图开关：返回 Scene.globals.bakedWithHighpLightmap。 该标记用于表明场景是否按高精度模式烘焙光照图。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sceneGetBakedWithHighpLightmap |
| 分类 | Cocos 节点 |
| 二级分类 | 场景 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scene | 场景 | 数据 | cc.Node / Scene | 目标场景 要读取或修改的 Scene 对象。 通常来自“获取当前场景”，或其它返回 Scene 的节点。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
bakedWithHighpLightmap | 高精度光照图 | 数据 | boolean | 高精度光照图开关 true 表示场景光照图使用高精度模式烘焙。 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
获取关闭光照图开关
获取关闭光照图开关：返回 Scene.globals.disableLightmap。 开启后表示场景整体禁用光照图效果，通常用于调试或特殊渲染切换。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sceneGetDisableLightmap |
| 分类 | Cocos 节点 |
| 二级分类 | 场景 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scene | 场景 | 数据 | cc.Node / Scene | 目标场景 要读取或修改的 Scene 对象。 通常来自“获取当前场景”，或其它返回 Scene 的节点。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
disableLightmap | 关闭光照图 | 数据 | boolean | 关闭光照图开关 true 表示场景禁用光照图效果。 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
获取光照探针配置
获取光照探针配置：返回 Scene.globals.lightProbeInfo。 可继续读取 GI 采样数、反弹次数、探针显示开关等配置。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sceneGetLightProbeInfo |
| 分类 | Cocos 节点 |
| 二级分类 | 场景 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scene | 场景 | 数据 | cc.Node / Scene | 目标场景 要读取或修改的 Scene 对象。 通常来自“获取当前场景”，或其它返回 Scene 的节点。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
lightProbeInfo | 光照探针配置 | 数据 | reference / LightProbeInfo | 光照探针配置 LightProbeInfo 对象。 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
获取后处理配置
获取后处理配置：返回 Scene.globals.postSettings。 当前主要用于读取色调映射类型等全局后处理设置。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sceneGetPostSettings |
| 分类 | Cocos 节点 |
| 二级分类 | 场景 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scene | 场景 | 数据 | cc.Node / Scene | 目标场景 要读取或修改的 Scene 对象。 通常来自“获取当前场景”，或其它返回 Scene 的节点。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
postSettings | 后处理配置 | 数据 | reference / PostSettingsInfo | 后处理配置 PostSettingsInfo 对象。 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
获取环境光配置
获取环境光配置：返回 Scene.globals.ambient。 可继续读取天空光颜色、地面颜色和天空亮度等环境光参数。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sceneGetAmbient |
| 分类 | Cocos 节点 |
| 二级分类 | 场景 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scene | 场景 | 数据 | cc.Node / Scene | 目标场景 要读取或修改的 Scene 对象。 通常来自“获取当前场景”，或其它返回 Scene 的节点。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
ambient | 环境光配置 | 数据 | reference / AmbientInfo | 环境光配置 AmbientInfo 对象。 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
获取静止主光烘焙开关
获取静止主光烘焙开关：返回 Scene.globals.bakedWithStationaryMainLight。 该标记用于表明场景是否按“静止主光源”模式进行过烘焙。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sceneGetBakedWithStationaryMainLight |
| 分类 | Cocos 节点 |
| 二级分类 | 场景 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scene | 场景 | 数据 | cc.Node / Scene | 目标场景 要读取或修改的 Scene 对象。 通常来自“获取当前场景”，或其它返回 Scene 的节点。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
bakedWithStationaryMainLight | 静止主光烘焙 | 数据 | boolean | 静止主光烘焙开关 true 表示场景按静止主光源模式烘焙。 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
获取皮肤后处理配置
获取皮肤后处理配置：返回 Scene.globals.skin。 可继续读取皮肤散射强度与模糊半径等参数。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sceneGetSkin |
| 分类 | Cocos 节点 |
| 二级分类 | 场景 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scene | 场景 | 数据 | cc.Node / Scene | 目标场景 要读取或修改的 Scene 对象。 通常来自“获取当前场景”，或其它返回 Scene 的节点。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
skin | 皮肤配置 | 数据 | reference / SkinInfo | 皮肤后处理配置 SkinInfo 对象。 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
获取天空盒配置
获取天空盒配置：返回 Scene.globals.skybox。 可继续读取环境贴图、环境光照模式、HDR 开关和天空盒旋转角度。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sceneGetSkybox |
| 分类 | Cocos 节点 |
| 二级分类 | 场景 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scene | 场景 | 数据 | cc.Node / Scene | 目标场景 要读取或修改的 Scene 对象。 通常来自“获取当前场景”，或其它返回 Scene 的节点。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
skybox | 天空盒配置 | 数据 | reference / SkyboxInfo | 天空盒配置 SkyboxInfo 对象。 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
获取雾效配置
获取雾效配置：返回 Scene.globals.fog。 可继续读取雾颜色、雾类型、起止距离或指数衰减参数。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sceneGetFog |
| 分类 | Cocos 节点 |
| 二级分类 | 场景 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scene | 场景 | 数据 | cc.Node / Scene | 目标场景 要读取或修改的 Scene 对象。 通常来自“获取当前场景”，或其它返回 Scene 的节点。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
fog | 雾效配置 | 数据 | reference / FogInfo | 雾效配置 FogInfo 对象。 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
获取渲染层场景
获取渲染层场景对象：返回 Scene 对应的 renderer.RenderScene。 这是只读渲染层对象，适合继续读取相机列表等渲染游戏运行时状态，不建议直接用于引擎内部生命周期控制。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sceneGetRenderScene |
| 分类 | Cocos 节点 |
| 二级分类 | 场景 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scene | 场景 | 数据 | cc.Node / Scene | 目标场景 要读取或修改的 Scene 对象。 通常来自“获取当前场景”，或其它返回 Scene 的节点。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
renderScene | 渲染层场景 | 数据 | reference / renderer.RenderScene | 渲染层场景 对应的 renderer.RenderScene，只读渲染层对象。 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
获取阴影配置
获取阴影配置：返回 Scene.globals.shadows。 可继续读取阴影类型、阴影颜色、阴影贴图尺寸等信息。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sceneGetShadows |
| 分类 | Cocos 节点 |
| 二级分类 | 场景 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scene | 场景 | 数据 | cc.Node / Scene | 目标场景 要读取或修改的 Scene 对象。 通常来自“获取当前场景”，或其它返回 Scene 的节点。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
shadows | 阴影配置 | 数据 | reference / ShadowsInfo | 阴影配置 ShadowsInfo 对象。 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
获取自动释放资产
获取自动释放资产开关：返回场景在切换后，是否默认自动释放其静态引用资产。 开启后有助于减少内存占用；关闭后更适合需要复用资产、避免重新加载抖动的场景。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sceneGetAutoReleaseAssets |
| 分类 | Cocos 节点 |
| 二级分类 | 场景 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scene | 场景 | 数据 | cc.Node / Scene | 目标场景 要读取或修改的 Scene 对象。 通常来自“获取当前场景”，或其它返回 Scene 的节点。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
autoReleaseAssets | 自动释放资产 | 数据 | boolean | 自动释放资产开关 true 表示场景切换后默认自动释放该场景静态引用到的资产。 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
设置高精度光照图开关
设置高精度光照图开关：修改 Scene.globals.bakedWithHighpLightmap。 建议仅在你明确知道当前场景光照图烘焙策略时修改它，以避免状态标记与真实烘焙产物不一致。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sceneSetBakedWithHighpLightmap |
| 分类 | Cocos 节点 |
| 二级分类 | 场景 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
scene | 场景 | 数据 | cc.Node / Scene | 目标场景 要读取或修改的 Scene 对象。 通常来自“获取当前场景”，或其它返回 Scene 的节点。 | - | 必填 |
bakedWithHighpLightmap | 高精度光照图 | 数据 | boolean | 高精度光照图开关 true 表示场景光照图使用高精度模式烘焙。 | 开关 默认值：false | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
scene | 场景 | 数据 | cc.Node / Scene | 场景对象 当前操作的 Scene，便于继续链式读取其它场景信息。 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
设置关闭光照图开关
设置关闭光照图开关：修改 Scene.globals.disableLightmap。 该节点会直接改变场景级光照图启用状态，适合调试、性能实验或游戏运行时渲染分级切换。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sceneSetDisableLightmap |
| 分类 | Cocos 节点 |
| 二级分类 | 场景 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
scene | 场景 | 数据 | cc.Node / Scene | 目标场景 要读取或修改的 Scene 对象。 通常来自“获取当前场景”，或其它返回 Scene 的节点。 | - | 必填 |
disableLightmap | 关闭光照图 | 数据 | boolean | 关闭光照图开关 true 表示场景禁用光照图效果。 | 开关 默认值：false | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
scene | 场景 | 数据 | cc.Node / Scene | 场景对象 当前操作的 Scene，便于继续链式读取其它场景信息。 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
设置静止主光烘焙开关
设置静止主光烘焙开关：修改 Scene.globals.bakedWithStationaryMainLight。 这是场景烘焙状态标记，通常用于与光照烘焙流程保持一致，而不是普通游戏逻辑中的高频开关。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sceneSetBakedWithStationaryMainLight |
| 分类 | Cocos 节点 |
| 二级分类 | 场景 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
scene | 场景 | 数据 | cc.Node / Scene | 目标场景 要读取或修改的 Scene 对象。 通常来自“获取当前场景”，或其它返回 Scene 的节点。 | - | 必填 |
bakedWithStationaryMainLight | 静止主光烘焙 | 数据 | boolean | 静止主光烘焙开关 true 表示场景按静止主光源模式烘焙。 | 开关 默认值：false | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
scene | 场景 | 数据 | cc.Node / Scene | 场景对象 当前操作的 Scene，便于继续链式读取其它场景信息。 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。
设置自动释放资产
设置自动释放资产开关：修改 Scene.autoReleaseAssets。 该设置会影响场景切换后的资产释放策略。建议在你明确知道资产生命周期规划时使用。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sceneSetAutoReleaseAssets |
| 分类 | Cocos 节点 |
| 二级分类 | 场景 |
| 分组 | - |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
scene | 场景 | 数据 | cc.Node / Scene | 目标场景 要读取或修改的 Scene 对象。 通常来自“获取当前场景”，或其它返回 Scene 的节点。 | - | 必填 |
autoReleaseAssets | 自动释放资产 | 数据 | boolean | 自动释放资产开关 true 表示场景切换后默认自动释放该场景静态引用到的资产。 | 开关 默认值：false | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
scene | 场景 | 数据 | cc.Node / Scene | 场景对象 当前操作的 Scene，便于继续链式读取其它场景信息。 | - | 可选 |
使用场景
- 动态创建、查找、移动或销毁节点
- 控制节点位置、旋转、缩放和可见性
- 获取或添加组件后继续调用组件节点
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 节点路径查找依赖场景层级，改名或移动节点后要同步检查。
- 销毁节点后不要继续使用旧引用。