游戏引擎 / 系统课时

Autoload 隔离跨场景状态

Autoload 隔离跨场景状态

切换关卡时,当前场景及其角色节点会被移除,但音量、语言等会话设置应继续有效。本课将这些设置放到 Autoload,把敌人数留在各自关卡中,通过一次真实的场景切换验证哪些数据保留、哪些对象被释放。

学习目标

  • 按生命周期划分 Autoload 常驻状态与关卡临时状态。
  • 配置自动加载脚本,并在两个场景中访问同一份会话设置。
  • 验证切关后的状态及旧节点失效,避免全局依赖堆积。

用生命周期决定状态归属

Godot 的 Autoload 会在普通主场景加载前,以命名节点的形式加入场景树根 /root。调用 SceneTree.change_scene_to_file() 替换当前场景时,这个常驻节点不会随旧关卡一起销毁。普通关卡节点则跟随其所在的场景实例创建和释放。

适合放入 Autoload 的是音量开关、语言选择、跨关卡进度等少量需要共享的会话数据。敌人、子弹、角色碰撞体及关卡 HUD 等有明确场景归属的节点,应由关卡自身管理。Autoload 不是严格限制实例数量的语言级单例,也不会自动把变量写入磁盘。

Autoload 与关卡临时节点的跨场景生命周期

配置一个会话状态入口

创建 res://session_state.gd,内容如下。它只保存会话设置,不依赖任何关卡节点;默认值将在本次运行开始时初始化。

gdscript
extends Node

# 仅存跨关卡共享的轻量设置,不保存敌人或角色对象引用
var music_enabled: bool = true
var language_code: String = "zh_CN"

在编辑器依次打开 Project → Project Settings → Globals → Autoload,选择 res://session_state.gd,名称填写 SessionState,点击添加并保持启用。引擎会在 /root/SessionState 创建该节点,其他 GDScript 脚本可用 SessionState.music_enabled 直接访问。

注册名称必须与代码中的 SessionState 一致。不要再手动创建同名脚本实例充当全局变量,否则修改的是不同节点;也不要在切关时对 Autoload 调用 queue_free()。

创建两个关卡验证切换

分别创建两个以 Node 为根的场景,根节点命名为 LevelA、LevelB,保存为 res://level_a.tscn 和 res://level_b.tscn。给它们分别挂载以下两个完整脚本,最后将 level_a.tscn 设为主场景并运行。

res://level_a.gd:

gdscript
extends Node

var remaining_enemies: int = 3

func _ready() -> void:
    SessionState.music_enabled = false
    remaining_enemies -= 1  # 只改变 A 的局部战斗状态
    print("A 音乐开关=", SessionState.music_enabled)
    print("A 剩余敌人=", remaining_enemies)
    # 延迟到本轮回调结束后再开始切换
    get_tree().call_deferred("change_scene_to_file", "res://level_b.tscn")

res://level_b.gd:

gdscript
extends Node

var remaining_enemies: int = 5

func _ready() -> void:
    print("B 音乐开关=", SessionState.music_enabled)
    print("B 剩余敌人=", remaining_enemies)
    # A 的根节点在切换后已不属于运行中的场景树
    print("旧关卡仍在树上=", get_tree().root.has_node("LevelA"))

预期输出(省略 Godot 启动信息):

text
A 音乐开关=false
A 剩余敌人=2
B 音乐开关=false
B 剩余敌人=5
旧关卡仍在树上=false

music_enabled 在 B 中仍为 false,说明双方读写的是同一个常驻节点。B 的敌人数来自自己的初始值 5,不会接续 A 的 2。旧关卡从场景树中移除,随后被释放;如果需要等待新场景完全建立,可以在常驻管理节点中监听 get_tree().scene_changed。

初始化依赖和失效引用

Autoload 按项目设置中的顺序加入场景树,且早于主场景运行。因此,其 _ready() 适合初始化自身配置,不适合假定当前关卡已经存在。若两个 Autoload 相互依赖,应明确顺序或提供显式初始化接口,避免隐式循环依赖。

不要把 LevelA 的玩家节点指针存进 SessionState 后跨关卡使用。切换释放旧场景时,这类引用会失效;确实需要短期持有时,应在使用前调用 is_instance_valid() 检查,并在关卡退出时清理。跨关卡识别目标通常保存稳定 ID 或普通数据,再由新场景重新查找。

如果脚本提示找不到 SessionState,先检查 Autoload 是否启用、名称拼写是否一致;如果 B 读到默认值,则检查是否意外创建了另一份状态对象。需要常驻的 HUD 可以做成独立的 Autoload 场景,但不应把整套关卡逻辑都塞入同一个全局脚本。游戏重启后仍要保留的设置,应另用 ConfigFile 或存档机制落盘。

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

目录与阅读设置

阅读设置

17

记录一个想法

Autoload 隔离跨场景状态

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

登录哪都通