游戏引擎 / 系统课时
场景切换何时取得新关卡节点
场景切换何时取得新关卡节点
场景切换调用返回成功,不代表新关卡已经进入场景树。立即读取 current_scene 可能得到空值,依赖旧关卡继续执行也不安全。本课让常驻协调节点等待 scene_changed,在新关卡初始化后再获取节点并交接状态。
学习目标
- 区分切换请求成功、旧场景离树和新场景可访问的时刻。
- 用常驻节点检查错误码并等待
scene_changed。 - 验证旧引用失效与新关卡可用,避免重复切换。
切换调用前后的时间窗口
Godot 4.6 的 SceneTree.change_scene_to_file(path) 会加载并准备目标 PackedScene,成功时返回 OK。切换开始后,旧关卡立即从场景树移除,此时 current_scene 暂时为 null;到当前帧末,旧场景被释放、新场景加入场景树并初始化,随后发出 scene_changed。
因此,错误码表示请求是否被接受,信号表示新场景是否已就绪。旧场景离树后,不能再依赖它的 get_tree();旧节点引用也不能跨过释放时刻继续调用方法。若返回 ERR_CANT_OPEN 或 ERR_CANT_CREATE,应直接处理失败,不能无条件等待信号。

由不会销毁的节点发起切换
准备两个场景 res://levels/level_a.tscn 与 res://levels/level_b.tscn,根节点分别命名 LevelA、LevelB,类型均为 Node2D。设置 LevelA 为项目主场景。创建 res://game_flow.gd,在“项目 → 项目设置 → 全局 → 自动加载(Autoload)”中注册为 GameFlow;它位于被替换的主场景之外。
game_flow.gd 的完整代码:
extends Node
var switching := false
func go_to_level(path: String) -> void:
if switching:
return
switching = true
var tree := get_tree()
var old_level := tree.current_scene
var result := tree.change_scene_to_file(path)
if result != OK:
print("切换失败:", error_string(result))
switching = false
return
# 调用返回时,旧关卡已离树,新关卡还未就绪
print("调用返回时为空:", tree.current_scene == null)
await tree.scene_changed
# 恢复和绑定逻辑必须在信号之后执行
var next_level := tree.current_scene
print("新关卡:", next_level.name)
print("旧引用有效:", is_instance_valid(old_level))
switching = false给 LevelA 根节点挂载 level_a.gd,按空格触发一次切换:
extends Node2D
func _unhandled_key_input(event: InputEvent) -> void:
if event is InputEventKey and event.pressed and not event.echo:
if event.keycode == KEY_SPACE:
# 旧关卡只提交请求,等待逻辑留在常驻 GameFlow
GameFlow.go_to_level("res://levels/level_b.tscn")预期输出:
调用返回时为空:true
新关卡:LevelB
旧引用有效:false在信号之后交接状态
scene_changed 发出时,新场景已加入树并完成初始化,因而可以读取根节点、连接信号或调用它提供的状态恢复方法。跨关卡的分数、存档进度等应先放在 GameFlow 或独立状态对象中,不要只保存在即将释放的 LevelA 子节点上。
如果目标路径写错,change_scene_to_file() 会返回非 OK 错误;示例先退出,避免等待不会因这次失败而发出的信号。switching 只拦截经由 GameFlow 的重复请求,项目中其他入口也应统一走它,防止并发切换造成信号与请求错配。
选择切换方式
整关替换适用于菜单进入关卡、关卡间不需要保留旧场景节点的情况。若 HUD、过场层或摄像机必须原样常驻,不要把它们放在被 change_scene_to_file() 替换的主场景里;应使用 Autoload 管理这些对象,或让主场景常驻、只替换其关卡容器。