游戏引擎 / 系统课时
理清 Scene 生命周期执行顺序
理清 Scene 生命周期执行顺序
这篇用一个可运行的 Phaser 4.2.1 场景记录初始化、资源加载、逐帧更新与退出的顺序。完成后,你能判断何时可以读取已加载资源,解释场景重启为何重新执行初始化,并在退出时清理外部事件监听。
学习目标
- 说清
init、preload、create、update与shutdown的触发时机。 - 在加载结束后安全读取资源缓存,避免过早创建依赖资源的对象。
- 用日志验证重启顺序,并在
shutdown时解绑浏览器级监听。
从启动到退出的调用边界
Phaser 4.2.1 在启动 Scene 时按以下顺序调用回调;shutdown 与前四项不同,它是场景停止时发出的事件,不是会自动调用的同名回调方法。
| 环节 | 触发时机 | 应做的事 |
|---|---|---|
init(data) |
每次启动或重启 | 接收场景参数,重置本轮状态 |
preload() |
init 之后 |
使用 this.load 登记待加载资源 |
create(data) |
Loader 完成之后 | 从缓存读取资源,创建游戏对象与输入监听 |
update(time, delta) |
进入 RUNNING 后每个游戏步 |
按毫秒级 delta 更新状态 |
shutdown 事件 |
stop() 或 restart() 导致场景停止 |
解除外部监听,释放场景持有的引用 |
preload() 登记加载任务,并不意味着其中的资源已经下载完毕。只有待加载队列完成后才进入 create();若不需要加载资源,则会直接进入创建阶段。场景实例的 constructor() 通常只在实例化时运行一次,不能代替每轮都会运行的 init()。

准备可验证的资源
使用 Node.js 与 npm 创建一个 Vite JavaScript 工程,并固定 Phaser 版本。下面命令在终端依次执行:
npm create vite@latest phaser-lifecycle -- --template vanilla
cd phaser-lifecycle
npm install
npm install phaser@4.2.1预期结果:工程内存在 src/main.js 与 package.json,依赖安装命令正常结束,phaser 版本为 4.2.1。如安装器询问是否继续,选择确认。
在项目的 public/level.json 新建资源文件:
{
"title": "测试关卡"
}Vite 会将 public 中的文件从站点根路径提供给浏览器,因此场景可用 /level.json 加载它。这个 JSON 是供 Loader 读取的真实资源,不是写在代码里的假数据。
实现 Scene 并打印调用顺序
将 src/main.js 替换为以下完整代码。日志只打印首次 update,避免每帧刷屏;按 R 将用同一个 Scene 实例重启下一轮。
import Phaser from 'phaser';
class LifecycleScene extends Phaser.Scene {
constructor() {
super('LifecycleScene');
}
init(data) {
// 每轮重新设定计数和首帧标志
this.round = data?.round ?? 1;
this.firstFrame = true;
console.log(`[${this.round}] init`);
}
preload() {
console.log(`[${this.round}] preload`);
// 首次载入后复用缓存,避免重启时重复请求
if (!this.cache.json.has('level')) {
this.load.json('level', '/level.json');
}
}
create() {
const level = this.cache.json.get('level');
console.log(`[${this.round}] create: ${level.title}`);
this.label = this.add.text(
24, 80, `${level.title}|第 ${this.round} 次\n按 R 重启`,
{ fontSize: '28px', color: '#ffffff' }
);
const onKeyDown = (event) => {
if (event.repeat || event.key.toLowerCase() !== 'r') return;
this.scene.restart({ round: this.round + 1 });
};
// 浏览器事件不会由 Phaser 自动替场景解绑
window.addEventListener('keydown', onKeyDown);
this.events.once(Phaser.Scenes.Events.SHUTDOWN, () => {
window.removeEventListener('keydown', onKeyDown);
console.log(`[${this.round}] shutdown`);
});
}
update(_time, delta) {
if (this.firstFrame) {
console.log(`[${this.round}] update`);
this.firstFrame = false;
}
// delta 单位为毫秒,与实际帧率无关
this.label.x += 20 * delta / 1000;
if (this.label.x > 120) this.label.x = 24;
}
}
new Phaser.Game({
type: Phaser.AUTO,
width: 640,
height: 360,
backgroundColor: '#132238',
scene: LifecycleScene
});预期结果:启动页面后会显示 640×360 的深色游戏画布、关卡标题和重启提示;create 读取到的 level.title 为“测试关卡”,每帧的文字位移速度约为每秒 20 像素。
运行、重启与排查错序
在项目根目录启动 Vite:
npm run dev预期输出(截取关键行):
Local: http://localhost:<PORT>/<PORT> 是实际开发端口,数值可能不同。打开终端给出的地址,在浏览器开发者工具 Console 中观察首次启动顺序:
[1] init
[1] preload
[1] create: 测试关卡
[1] update按一次 R 后会继续看到:
[1] shutdown
[2] init
[2] preload
[2] create: 测试关卡
[2] update如果在 init() 里调用 this.cache.json.get('level'),首次启动时资源可能尚不存在;应把依赖加载结果的代码放到 create()。如果 level.title 报错,检查 public/level.json 的位置,以及 Network 面板中 /level.json 是否成功返回。不要在 preload() 里直接执行一个未交给 Phaser Loader 管理的异步 fetch,却假定 create() 会等待它。
restart() 会触发旧一轮的 shutdown,并重新运行 init、preload、create;pause/resume 和 sleep/wake 则保留当前场景状态,不重新调用这些初始化回调。示例用 events.once(SHUTDOWN, ...) 移除 window 监听,连续重启十次后按一次 R 仍应只推进一轮。