游戏引擎 / 系统课时
场景容器替换关卡而保留界面
场景容器替换关卡而保留界面
如果直接更换主场景,挂在主场景下面的 HUD 也会随之释放。本课把 Main 固定为项目主场景,只更换 LevelSlot 的关卡子节点,并让 HUD 保持在独立分支。切换前先载入和校验候选关卡,失败时继续使用原关卡。
学习目标
- 设计
Main、LevelSlot和HUD的常驻与可替换边界。 - 按“载入、实例化、注入依赖、移除旧关卡、挂入新关卡”完成替换。
- 验证界面不重建、旧关卡被释放和失败时保留原关卡。
常驻根节点与可替换子树
创建 res://main.tscn:根节点 Main 使用 Node,其下有同级子节点 LevelSlot(Node2D)和 HUD(CanvasLayer),HUD 下再放一个 Label,名称为 Status。运行时只允许 LevelSlot 持有活动关卡实例;HUD/Status 不随关卡切换而销毁。
这与 change_scene_to_file() 的区别在于:SceneTree.current_scene 始终是 Main,并非 LevelSlot 中的关卡。关卡内不要使用指向 ../../HUD 的固定父级路径,应由 Main 注入界面或会话服务的引用,避免关卡被单独复用时路径失效。

准备关卡场景与依赖接口
创建两个场景 res://levels/level_a.tscn、res://levels/level_b.tscn,根节点都是 Node2D,分别命名 LevelA 和 LevelB。两者都挂载以下 res://level.gd;在检查器中把导出的 level_name 分别设置为 A 和 B。
extends Node2D
@export var level_name: String = "未命名"
var hud_label: Label
func configure(label: Label) -> void:
# 在节点入树前注入依赖,让 _ready 可以安全使用
hud_label = label
func _ready() -> void:
hud_label.text = "当前关卡:" + level_name
print("关卡就绪:", level_name)
func _exit_tree() -> void:
print("关卡离树:", level_name)这个接口刻意很小:关卡只接收需要使用的对象,不负责寻找主场景,也不持有管理其他关卡的权限。此例用 Label 展示数据交接;真实项目可以改为较稳定的 HUD 接口或状态服务,减少对具体控件的依赖。
先构建候选对象再清理旧关卡
将以下完整脚本保存为 res://main.gd 并挂到 Main。设置 main.tscn 为项目主场景。按数字键 1、2 切换关卡,按 0 测试不存在的资源路径。
extends Node
const LEVEL_A := "res://levels/level_a.tscn"
const LEVEL_B := "res://levels/level_b.tscn"
# LevelSlot 是唯一可替换分支,HUD 保持常驻
@onready var level_slot: Node2D = $LevelSlot
@onready var status_label: Label = $HUD/Status
var active_level: Node2D
func _ready() -> void:
switch_level(LEVEL_A)
func _unhandled_key_input(event: InputEvent) -> void:
if event is InputEventKey and event.pressed and not event.echo:
match event.keycode:
KEY_1:
switch_level(LEVEL_A)
KEY_2:
switch_level(LEVEL_B)
KEY_0:
switch_level("res://levels/missing.tscn")
func switch_level(path: String) -> void:
# 校验与实例化失败都不触碰旧关卡
if not ResourceLoader.exists(path, "PackedScene"):
print("资源不可用,保留原关卡")
return
var packed := ResourceLoader.load(path) as PackedScene
if packed == null:
print("资源载入失败,保留原关卡")
return
var instance := packed.instantiate()
if not instance is Node2D:
if instance != null:
instance.free()
print("根节点类型不符,保留原关卡")
return
var candidate: Node2D = instance as Node2D
if not candidate.has_method("configure"):
candidate.free()
print("缺少 configure,保留原关卡")
return
# 装配完成前绝不释放旧关卡
candidate.call("configure", status_label)
if is_instance_valid(active_level):
# 先预约释放再离树,防止旧关卡继续运行
active_level.queue_free()
level_slot.remove_child(active_level)
level_slot.add_child(candidate)
active_level = candidate
print("替换完成:", candidate.name)依次启动、按 2、再按 0,预期输出:
关卡就绪:A
替换完成:LevelA
关卡离树:A
关卡就绪:B
替换完成:LevelB
资源不可用,保留原关卡验证失败边界与释放时机
切到 B 后,HUD/Status 应显示“当前关卡:B”,且它始终是同一个 Label 实例。按 0 时因为资源不存在,代码在删除旧关卡之前返回,界面与 LevelB 都保持不变。还可以将场景根节点改为非 Node2D,或移除其 configure 方法,分别检查类型与装配契约校验。
queue_free() 先预约帧末删除,再由 remove_child() 立即让旧关卡离树;这两步不能只做后者,否则旧实例会留在内存中。示例的保护范围是资源可用、根类型和注入接口:它不能自动回滚新关卡 _ready() 中的脚本错误。正式项目应让 _ready() 尽量简单,把可能失败的依赖准备放在替换前,并在物理回调触发切换时通过 call_deferred() 调度结构修改。
只有需要始终保留 HUD、会话控制器或加载遮罩时,常驻主场景才值得承担这层管理职责;短小且全部可销毁的关卡仍可使用标准场景切换 API。