游戏引擎 / 系统课时

理清 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()。

Scene 启动、加载、运行与停止的状态转换

准备可验证的资源

使用 Node.js 与 npm 创建一个 Vite JavaScript 工程,并固定 Phaser 版本。下面命令在终端依次执行:

bash
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 新建资源文件:

json
{
  "title": "测试关卡"
}

Vite 会将 public 中的文件从站点根路径提供给浏览器,因此场景可用 /level.json 加载它。这个 JSON 是供 Loader 读取的真实资源,不是写在代码里的假数据。

实现 Scene 并打印调用顺序

将 src/main.js 替换为以下完整代码。日志只打印首次 update,避免每帧刷屏;按 R 将用同一个 Scene 实例重启下一轮。

js
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:

bash
npm run dev

预期输出(截取关键行):

text
Local: http://localhost:<PORT>/

<PORT> 是实际开发端口,数值可能不同。打开终端给出的地址,在浏览器开发者工具 Console 中观察首次启动顺序:

text
[1] init
[1] preload
[1] create: 测试关卡
[1] update

按一次 R 后会继续看到:

text
[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 仍应只推进一轮。

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

目录与阅读设置

阅读设置

17

记录一个想法

理清 Scene 生命周期执行顺序

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

登录哪都通