游戏引擎 / 系统课时

用 Registry 共享跨场景状态

用 Registry 共享跨场景状态

关卡场景负责累加分数,HUD 场景负责显示分数。如果各自保存一份,切换场景后很容易不同步。这里用 Phaser 4.2.1 的游戏级 Registry 作为共享数据源,完成跨场景读写、实时刷新,并区分每局临时计数与全局进度。

学习目标

  • 使用 this.registry.set()、get() 和 inc() 在不同 Scene 之间共享数值。
  • 通过 changedata-score 事件同步 HUD,并在场景关闭时解除监听。
  • 判断哪些数据留在 Registry,哪些放在场景内部,以及何时需要另行存档。

Registry 和局内状态的边界

每个 Phaser 游戏有一个 game.registry(DataManager),所有 Scene 中的 this.registry 都指向它。适合存放当前总分、当前关卡编号、音量设置等需要被多个场景读取的数据;但它只是当前网页运行期间的内存数据,不是浏览器存档。

数据 推荐位置 具体理由
score = 30 this.registry GameScene 修改,UIScene 显示
pressCount = 3 GameScene 的 this.data 仅统计本局操作,进关卡时显式归零
当前碰撞对象、无敌计时器 Scene 字段或对象实例 与具体关卡和对象生命周期绑定

this.data 是当前 Scene 自己的 Data Manager,不会自动变成跨场景共享存储;即使用它保存短期值,也应在每次进关卡时明确初始化。以下结构图标出数据所有者与事件方向。

GameScene 与 UIScene 通过全局 Registry 共享分数的数据流

两个场景共用分数

把下面完整示例保存为 index.html,联网后用浏览器打开;示例使用 Phaser 4.2.1 CDN,不需要图片资源。GameScene 接收空格键并修改共享分数,UIScene 只负责显示。pressCount 留在游戏场景内。

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="utf-8">
  <title>Phaser Registry 演示</title>
</head>
<body style="margin:0">
<script src="https://cdn.jsdelivr.net/npm/phaser@4.2.1/dist/phaser.min.js"></script>
<script>
class GameScene extends Phaser.Scene {
  constructor() { super('GameScene'); }

  create() {
    // 已有进度不覆盖;本局临时数据从零开始
    if (!this.registry.has('score')) this.registry.set('score', 0);
    this.data.set('pressCount', 0);

    this.add.text(20, 90, '按空格键:每次加 10 分', {
      fontFamily: 'Arial', fontSize: '22px', color: '#ffffff'
    });
    const localText = this.add.text(20, 130, '本局按键:0', {
      fontFamily: 'Arial', fontSize: '20px', color: '#ffffff'
    });

    this.input.keyboard.on('keydown-SPACE', () => {
      const count = this.data.get('pressCount') + 1;
      this.data.set('pressCount', count);
      this.registry.inc('score', 10);
      localText.setText(`本局按键:${count}`);
    });

    this.scene.launch('UIScene');
  }
}

class UIScene extends Phaser.Scene {
  constructor() { super('UIScene'); }

  create() {
    // 先读取当前值,防止错过订阅前的首次 setdata
    const scoreText = this.add.text(
      20, 20, `总分:${this.registry.get('score')}`,
      { fontFamily: 'Arial', fontSize: '28px', color: '#ffffff' }
    );
    const onScoreChanged = (_game, value) => {
      scoreText.setText(`总分:${value}`);
    };
    this.registry.events.on('changedata-score', onScoreChanged);

    // 全局事件源不会随 UIScene 关闭而自动移除监听
    this.events.once(Phaser.Scenes.Events.SHUTDOWN, () => {
      this.registry.events.off('changedata-score', onScoreChanged);
    });
  }
}

new Phaser.Game({
  type: Phaser.AUTO,
  width: 640,
  height: 240,
  backgroundColor: '#1b3345',
  scene: [GameScene, UIScene]
});
</script>
</body>
</html>

预期结果: 页面最初显示“总分:0”和“本局按键:0”。先单击画布让页面获得焦点,再逐次轻按空格键 3 次,两个数字分别变为“总分:30”和“本局按键:3”;刷新页面后都回到 0。

事件订阅与清理

第一次执行 registry.set('score', 0) 创建键时发出的是 setdata,已有键再次赋值或通过 inc() 更新时才有 changedata-score。因此 HUD 必须先 get() 初始值,再监听变更;否则初始的 0 可能不显示。

监听器挂在 this.registry.events,而不是 this.events。如果 UIScene 每次启动都注册匿名回调却不解绑,关闭场景后旧回调仍可能被触发,轻则重复刷新,重则访问已销毁文本对象。示例把处理函数保存为 onScoreChanged,在 SHUTDOWN 时用同一函数引用 off() 解绑。

验收和故障定位

如果按空格没有反应,先确认浏览器已加载 CDN、画布获得键盘焦点,且按的是空格而不是长按造成重复触发;控制台出现 Phaser is not defined 通常表示 Phaser 脚本未成功加载。

如果游戏区计数在增加,HUD 却不变,依次核对两个场景是否使用相同的键名 score、是否监听 registry.events、初始值是否先通过 get() 读取。键名大小写不同会被当作两个键。

退出并重新进入关卡时,可重置 this.data 中的局内状态,但不要无条件把 Registry 总分设为 0。需要新开一局时才显式重置共享分数。Registry 不会把数据写入磁盘;若要求关闭网页后继续游戏,还需将可序列化的存档字段另行保存到持久化存储。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 Registry 共享跨场景状态

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

登录哪都通