游戏引擎 / 系统课时

切换场景时保留必要状态

切换场景时保留必要状态

大厅进入战斗再返回时,金币和关卡进度应保留,但界面与敌人应随场景重建。本课用 Cocos Creator 3.8 常驻根节点保存会话数据,演示 Lobby → Battle → Lobby 往返及正确清理,并区分运行状态和存档。

学习目标

  • 区分场景临时对象、跨场景状态和重启后仍需保留的存档。
  • 创建常驻根节点,在两个业务场景间读写同一份数据。
  • 避免重复创建常驻节点,并在会话结束时正确清理。

先决定哪些数据需要跨场景

切换场景通常会销毁旧场景中的普通节点与组件。如果把金币放在大厅 UI 脚本中,离开大厅后这个实例就不再可靠;返回时重新创建的脚本会得到初始值。

内容 合适的归属 切换后的行为
金币、当前关卡、本局选择 会话状态对象 沿用原值
大厅按钮、战斗敌人、临时特效 当前业务场景 销毁后重新创建
音量设置、已解锁关卡 存档或本地存储 应用重启后恢复

不要为了保存几项数值而把整个战斗场景常驻。数据应当轻量,场景中的 Node、Camera、组件引用应当只在所属场景有效。

常驻节点与场景如何配合

创建一次性的 Boot 场景,其中 SessionRoot 是场景根节点的直接子节点;给它添加 SessionStore 组件,再切入 Lobby。director.addPersistRootNode 让该根节点在后续场景切换时保留,而 Lobby 和 Battle 各自的普通节点仍然重建。

Boot 常驻状态与 Lobby、Battle 场景切换的数据关系

常驻节点只是运行期对象:它不能替代存档,也不应长期抓住 Battle 中的敌人或摄像机引用,否则旧场景对象可能无法按预期清理。

实现最小跨场景示例

新建 Boot.scene、Lobby.scene、Battle.scene,确保三者均可由场景名称加载,并把 Boot 设为启动场景。只在 Boot 中创建根层级 SessionRoot 并挂载下面的 SessionStore.ts;不要在 Lobby 或 Battle 再放一份。

ts
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。示例根据场景名自动完成往返,无需绑定按钮。

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');
    }
  }
}

验证与退出清理

预期输出(按顺序观察业务日志):

text
Lobby: coins=0
Battle: coins=3
Lobby: coins=3

第三行仍为 3,说明新建的大厅读取了同一个 SessionStore;如果再次出现 0,应检查启动场景、SessionRoot 的根层级位置,以及是否在每个场景重复创建了状态节点。场景加载失败时,应先检查场景文件名和构建场景配置。

需要彻底结束本局时,先用 director.removePersistRootNode(session.node) 取消常驻,再销毁该节点;onDestroy 会清除静态入口。重启后还要保留的数据,应单独序列化到存档系统或 sys.localStorage,并在启动时校验和恢复,而不是依赖常驻节点。

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

目录与阅读设置

阅读设置

17

记录一个想法

切换场景时保留必要状态

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

登录哪都通