游戏引擎 / 系统课时
用 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,不会自动变成跨场景共享存储;即使用它保存短期值,也应在每次进关卡时明确初始化。以下结构图标出数据所有者与事件方向。

两个场景共用分数
把下面完整示例保存为 index.html,联网后用浏览器打开;示例使用 Phaser 4.2.1 CDN,不需要图片资源。GameScene 接收空格键并修改共享分数,UIScene 只负责显示。pressCount 留在游戏场景内。
<!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 不会把数据写入磁盘;若要求关闭网页后继续游戏,还需将可序列化的存档字段另行保存到持久化存储。