游戏引擎 / 系统课时

场景切换何时取得新关卡节点

场景切换何时取得新关卡节点

场景切换调用返回成功,不代表新关卡已经进入场景树。立即读取 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 的完整代码:

gdscript
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,按空格触发一次切换:

gdscript
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")

预期输出:

text
调用返回时为空:true
新关卡:LevelB
旧引用有效:false

在信号之后交接状态

scene_changed 发出时,新场景已加入树并完成初始化,因而可以读取根节点、连接信号或调用它提供的状态恢复方法。跨关卡的分数、存档进度等应先放在 GameFlow 或独立状态对象中,不要只保存在即将释放的 LevelA 子节点上。

如果目标路径写错,change_scene_to_file() 会返回非 OK 错误;示例先退出,避免等待不会因这次失败而发出的信号。switching 只拦截经由 GameFlow 的重复请求,项目中其他入口也应统一走它,防止并发切换造成信号与请求错配。

选择切换方式

整关替换适用于菜单进入关卡、关卡间不需要保留旧场景节点的情况。若 HUD、过场层或摄像机必须原样常驻,不要把它们放在被 change_scene_to_file() 替换的主场景里;应使用 Autoload 管理这些对象,或让主场景常驻、只替换其关卡容器。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

场景切换何时取得新关卡节点

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通