游戏引擎 / 系统课时
切换场景时保留必要状态
切换场景时保留必要状态
大厅进入战斗再返回时,金币和关卡进度应保留,但界面与敌人应随场景重建。本课用 Cocos Creator 3.8 常驻根节点保存会话数据,演示 Lobby → Battle → Lobby 往返及正确清理,并区分运行状态和存档。
学习目标
- 区分场景临时对象、跨场景状态和重启后仍需保留的存档。
- 创建常驻根节点,在两个业务场景间读写同一份数据。
- 避免重复创建常驻节点,并在会话结束时正确清理。
先决定哪些数据需要跨场景
切换场景通常会销毁旧场景中的普通节点与组件。如果把金币放在大厅 UI 脚本中,离开大厅后这个实例就不再可靠;返回时重新创建的脚本会得到初始值。
| 内容 | 合适的归属 | 切换后的行为 |
|---|---|---|
| 金币、当前关卡、本局选择 | 会话状态对象 | 沿用原值 |
| 大厅按钮、战斗敌人、临时特效 | 当前业务场景 | 销毁后重新创建 |
| 音量设置、已解锁关卡 | 存档或本地存储 | 应用重启后恢复 |
不要为了保存几项数值而把整个战斗场景常驻。数据应当轻量,场景中的 Node、Camera、组件引用应当只在所属场景有效。
常驻节点与场景如何配合
创建一次性的 Boot 场景,其中 SessionRoot 是场景根节点的直接子节点;给它添加 SessionStore 组件,再切入 Lobby。director.addPersistRootNode 让该根节点在后续场景切换时保留,而 Lobby 和 Battle 各自的普通节点仍然重建。

常驻节点只是运行期对象:它不能替代存档,也不应长期抓住 Battle 中的敌人或摄像机引用,否则旧场景对象可能无法按预期清理。
实现最小跨场景示例
新建 Boot.scene、Lobby.scene、Battle.scene,确保三者均可由场景名称加载,并把 Boot 设为启动场景。只在 Boot 中创建根层级 SessionRoot 并挂载下面的 SessionStore.ts;不要在 Lobby 或 Battle 再放一份。
import { _decorator, Component, director } from 'cc';
const { ccclass } = _decorator;
@ccclass('SessionStore')
export class SessionStore extends Component {
static instance: SessionStore | null = null;
coins = 0;
onLoad() {
if (SessionStore.instance) {
this.node.destroy();
return;
}
SessionStore.instance = this;
// 常驻节点必须直接挂在场景根节点下面
director.addPersistRootNode(this.node);
}
start() {
director.loadScene('Lobby');
}
onDestroy() {
if (SessionStore.instance === this) {
SessionStore.instance = null;
}
}
}预期结果:Boot 启动后,SessionRoot 注册为常驻根节点,随后进入 Lobby;下一段脚本负责演示读写与往返。
接着在 Lobby 和 Battle 各放一个普通节点,挂载同一份 SceneEntry.ts。示例根据场景名自动完成往返,无需绑定按钮。
import { _decorator, Component, director } from 'cc';
import { SessionStore } from './SessionStore';
const { ccclass } = _decorator;
@ccclass('SceneEntry')
export class SceneEntry extends Component {
start() {
const store = SessionStore.instance;
const scene = director.getScene()?.name;
if (!store || !scene) {
console.error('会话尚未初始化');
return;
}
console.log(`${scene}: coins=${store.coins}`);
if (scene === 'Lobby' && store.coins === 0) {
// 进入战斗前修改共享数据,旧 Lobby 不负责保存
store.coins = 3;
director.loadScene('Battle');
} else if (scene === 'Battle') {
director.loadScene('Lobby');
}
}
}验证与退出清理
预期输出(按顺序观察业务日志):
Lobby: coins=0
Battle: coins=3
Lobby: coins=3第三行仍为 3,说明新建的大厅读取了同一个 SessionStore;如果再次出现 0,应检查启动场景、SessionRoot 的根层级位置,以及是否在每个场景重复创建了状态节点。场景加载失败时,应先检查场景文件名和构建场景配置。
需要彻底结束本局时,先用 director.removePersistRootNode(session.node) 取消常驻,再销毁该节点;onDestroy 会清除静态入口。重启后还要保留的数据,应单独序列化到存档系统或 sys.localStorage,并在启动时校验和恢复,而不是依赖常驻节点。