游戏引擎 / 系统课时

用 depth 控制对象遮挡顺序

用 depth 控制对象遮挡顺序

角色被背景意外盖住、前景物体无法遮挡角色,通常是绘制顺序不符合预期。Phaser 4 可以通过 depth 控制同一显示列表中的对象层级。本课将建立背景、角色、前景和界面的深度规则,并验证相同深度下的遮挡顺序。

学习目标

  • 理解 depth、绘制顺序与 Display List 的关系。
  • 使用 setDepth() 设置背景、角色和前景的遮挡层级。
  • 验证同层对象的先后顺序,排查常见遮挡异常。

depth 如何决定谁盖住谁

Phaser 4.2.1 的每个 Scene 都有自己的 Display List(显示列表),用于管理参与渲染的游戏对象。对象的 depth 是数值属性,默认值为 0。

渲染时,深度较小的对象先绘制,深度较大的对象后绘制。后绘制的对象会覆盖先绘制对象的重叠像素。深度可以是负数、小数或整数,不需要连续。

例如,一个横版游戏可以采用以下层级约定:

对象类别 depth 遮挡结果
背景 -10 位于场景物体后方
玩家角色 0 显示在背景前方
前景墙体 10 遮挡角色的部分身体
HUD 界面 100 显示在普通场景物体上方

这不是 Phaser 强制规定的取值,而是项目自行制定的层级约定。使用 -100、0、100 也能得到相同的相对顺序。

如果两个对象的 depth 相同,则依据它们在 Display List 中的位置决定顺序。通常情况下,先创建并加入列表的对象先绘制,后加入的对象后绘制。

不同 depth 与相同 depth 下的对象遮挡顺序

depth 控制的是绘制层级,不会自动改变对象的屏幕坐标、碰撞体位置或物理行为。例如角色设置为 depth=20,只会改变视觉覆盖关系,不会因此跳到墙体另一侧。

用 setDepth 创建可验证的遮挡场景

下面使用 Phaser 4.2.1 和 Vite 创建一个不依赖图片资源的演示。蓝灰色矩形代表背景,绿色圆形代表角色,橙色矩形代表前景墙,另外两个重叠的方块用来观察同层顺序。

在安装了兼容当前 Vite 版本的 Node.js 与 npm 后,执行:

bash
npm create vite@latest phaser-depth-demo -- --template vanilla
cd phaser-depth-demo
npm install
npm install phaser@4.2.1

预期结果:项目依赖安装成功,package.json 中包含 Phaser 4.2.1 对应的依赖记录,且 node_modules 中存在 Phaser 包。npm 的安装数量和审计信息随环境变化,不作为验收条件。

将 Vite 工程的 src/main.js 完整替换为以下代码。Vite 原始 index.html 中的 #app 容器用于挂载画布。

js
import Phaser from 'phaser';

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

  create() {
    // 故意先创建前景、最后创建背景,验证 depth 优先于创建顺序
    this.add.rectangle(320, 240, 440, 90, 0xd99563).setDepth(10);
    const player = this.add.circle(320, 215, 46, 0x37cba6).setDepth(0);
    this.add.rectangle(320, 180, 640, 360, 0x24354d).setDepth(-10);

    // 深度相同:后加入的紫色方块覆盖蓝色方块
    this.add.rectangle(120, 105, 90, 70, 0x6aa8ed).setDepth(5);
    this.add.rectangle(155, 125, 90, 70, 0x9f7be8).setDepth(5);

    this.add.text(18, 18, '空格:切换角色 depth 0 / 20', {
      fontSize: '19px',
      color: '#ffffff'
    }).setDepth(100);

    // 按空格切换角色深度,直接比较遮挡变化
    this.input.keyboard.on('keydown-SPACE', () => {
      player.setDepth(player.depth === 0 ? 20 : 0);
    });
  }
}

new Phaser.Game({
  type: Phaser.AUTO,
  width: 640,
  height: 360,
  parent: 'app',
  scene: DepthScene
});

预期结果:浏览器画布中,蓝灰色背景位于最底层,橙色前景墙遮住绿色角色的下半部分。画面左上区域的紫色方块覆盖蓝色方块的重叠区域。顶部白色提示文字始终可见。

这里特意把背景放在最后创建。如果所有对象都保持默认 depth=0,最后加入的背景会覆盖前面创建的对象;设置不同的深度后,即使创建顺序相反,也能得到正确的层级。

运行并检查同层对象的顺序

在项目目录启动开发服务器:

bash
npm run dev

预期输出包含类似地址:

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

<PORT> 是开发服务器实际使用的端口,具体数值可能不同。用浏览器打开终端显示的地址,确认能看到 640×360 的 Phaser 画布。

按下空格键观察角色的遮挡变化:

操作 角色 depth 预期可见结果
初始状态 0 橙色前景墙遮住角色下部
按一次空格 20 角色绘制在前景墙之上,完整圆形可见
再按一次空格 0 恢复墙体遮挡角色下部

代码里的 player.setDepth() 会请求场景重新进行深度排序,Phaser 在后续渲染过程中处理排序,不需要每帧手动调用 depthSort()。

再观察左上方的两个方块。它们都设置为 depth=5,蓝色方块先创建,紫色方块后创建,因此紫色位于上方。

可以交换这两条 this.add.rectangle() 语句的创建顺序,刷新页面再次验证:同样的深度值下,最终覆盖关系会随显示列表顺序变化。

实际项目里,如果确实需要临时调整同层对象的位置,可以使用 this.children.bringToTop(gameObject) 或 this.children.sendToBack(gameObject) 操作场景显示列表。但这些操作不改变对象的 depth,不同深度的对象在下一次深度排序后仍以深度为优先规则。因此,固定的背景、角色、前景层级应优先使用明确的 depth 值。

遮挡不符合预期时检查什么

当角色依然被错误遮挡时,按以下顺序检查,比反复调节坐标更有效。

  1. 确认深度值。 打印或读取相关对象的 depth 属性,检查是否出现背景为 10、角色为 0 这样的反向设置。也要注意通过 depth 属性直接赋值同样会触发排序。
  2. 检查同层顺序。 如果两个对象都是 depth=0,查看创建和加入 Display List 的先后关系。不要默认写在代码前面的对象就一定在画面前方。
  3. 确认是否属于同一显示列表。 Scene、Layer 和 Container 都可能形成不同的渲染排序范围。Container 的子对象不能仅靠自己的 depth 超越父 Container 在外部显示列表中的层级;Layer 内子对象的深度也主要在所属 Layer 内比较。
  4. 检查是否跨 Scene。 不同 Scene 之间的最终覆盖顺序由 Scene 的渲染顺序控制。不能简单地用一个 Scene 内部对象的 depth=1000 覆盖另一个后渲染的 Scene。

对于俯视角或伪 3D 的角色遮挡,还可以按对象脚底的世界坐标 y 动态设置深度。例如角色向屏幕下方移动时,使用 player.setDepth(player.y),使其相对同类对象更靠前。不过这种规则要求比较对象使用相同的坐标基准;大型背景和固定 HUD 仍应安排在单独的深度范围。

当遮挡异常出现时,先确认对象是否处于可比较的显示列表,再检查 depth,最后检查同深度下的列表顺序。通过这些检查,通常可以在不修改角色坐标或碰撞逻辑的情况下修正渲染层级。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 depth 控制对象遮挡顺序

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

登录哪都通