游戏引擎 / 系统课时

用 Overlap 识别道具触发区

用 Overlap 识别道具触发区

玩家捡到金币、钥匙或进入传送门时,通常只需要检测身体是否进入触发范围,不应该被道具挡住。下面使用 Phaser 4.2.1 的 Arcade Physics 做一个无需图片素材的拾取场景:玩家穿过道具时加分一次,道具消失,持续重叠也不会重复计分。

学习目标

  • 区分 overlap 的重叠检测与 collider 的碰撞分离。
  • 为动态玩家和静态道具注册拾取回调。
  • 通过状态保护与禁用物理体避免重复领取,并完成可观察的验收。

判断应该使用哪种检测

this.physics.add.overlap(a, b, callback) 会在物理世界每次更新时检测两者的 Arcade Body。检测到重叠就调用回调,不负责把重叠物体推开;this.physics.add.collider(a, b, callback) 除了触发回调,还会尝试进行位置分离和速度响应。

需求 使用接口 玩家经过时
墙壁、地板、实体障碍 collider 尝试阻挡或分离
金币、存档点、传送门触发区 overlap 允许穿过并触发逻辑

静态物理体只意味着它不随速度模拟移动,并不妨碍它作为拾取检测对象。这里让玩家使用动态体、道具使用静态体,避免给静止金币施加不必要的速度与重力。Arcade 默认按物理体的矩形或圆形范围判断,不按画面像素的透明度判断。

制作可穿过的金币

在 Node.js 与 npm 可用的环境中,依次执行 npm create vite@latest overlap-demo -- --template vanilla、cd overlap-demo、npm install、npm install phaser@4.2.1。然后用下列完整代码替换 src/main.js;Vite 默认的 index.html 会加载该入口。

js
import Phaser from 'phaser';

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

  create() {
    this.score = 0;
    this.pickedUp = false; // 单道具示例:领取状态归本场景管理
    this.add.text(20, 20, '按左右方向键移动', { fontSize: '22px', color: '#243747' });
    this.hud = this.add.text(20, 52, '已领取:0', { fontSize: '22px', color: '#243747' });

    this.player = this.add.rectangle(100, 225, 40, 40, 0x19a69b);
    this.physics.add.existing(this.player); // 创建动态 Arcade Body
    this.player.body.setCollideWorldBounds(true);

    const item = this.add.rectangle(540, 225, 32, 32, 0xf4a340);
    this.physics.add.existing(item, true); // 静态体也能参加 overlap
    this.cursors = this.input.keyboard.createCursorKeys();

    this.physics.add.overlap(this.player, item, (_player, hitItem) => {
      if (this.pickedUp || !hitItem.active) return;
      this.pickedUp = true; // 先封锁重复领取,再更新分数
      this.score += 1;
      this.hud.setText(`已领取:${this.score}`);
      this.physics.world.disable(hitItem);
      hitItem.setActive(false).setVisible(false);
    });
  }

  update() {
    const left = this.cursors.left.isDown;
    const right = this.cursors.right.isDown;
    this.player.body.setVelocityX(left === right ? 0 : (left ? -200 : 200));
  }
}

new Phaser.Game({
  type: Phaser.AUTO,
  width: 800,
  height: 450,
  backgroundColor: '#ffffff',
  physics: { default: 'arcade', arcade: { gravity: { x: 0, y: 0 }, debug: false } },
  scene: PickupScene
});

预期结果:页面出现 800×450 的白色游戏画面,左侧青绿色方块是玩家,右侧橙黄色方块是道具,左上角显示“已领取:0”。按住右方向键移动,接触道具后它立即消失,文字变为“已领取:1”;玩家不会被道具弹开或阻挡。

阻止每个物理步重复计分

overlap 不是只在“首次进入区域”触发的事件:两者持续重叠时,回调可能在连续多个物理步中执行。例如物理世界按每秒 60 步更新,站在触发区一秒可能让不设防的 score += 1 执行数十次。

本例按顺序先检查 pickedUp,再将它置为 true,然后加分,并通过 this.physics.world.disable(hitItem) 将道具物理体移出检测,最后隐藏游戏对象。状态标记负责业务去重,禁用 Body 负责停止后续物理检测;仅调用 setVisible(false) 会隐藏图形,却不会自动关闭物理碰撞。

Overlap 拾取判定和防重复领取流程

本例只有一件道具,因此使用一个场景级布尔值。若一关有十枚金币,不要共用同一个 pickedUp:应给每枚道具分别记录领取状态,或在领取回调中立即禁用对应道具的 Body,否则拾取第一枚后可能让其余金币也失效。

验证触发和定位异常

运行 npm run dev,在终端显示的本地地址打开页面;实际端口可能不同。按住右方向键约两秒,让玩家从横坐标 100 附近移动到道具所在的 540 附近,检查以下结果:

  1. 接触前计数为 0;接触后只增加到 1,道具立即消失。
  2. 继续按住右键,玩家仍可经过原道具位置,分数不会增加到 2。
  3. 按左键返回原位置,再穿过一次,分数依然是 1。

如果道具可见却不能拾取,先检查配置中 physics.default 是否为 arcade、双方是否都执行了 this.physics.add.existing,再临时把 debug: false 改为 debug: true,查看物理体边框是否处于预期位置。若玩家被挡住,检查是不是把触发器误注册成 this.physics.add.collider;若隐藏后仍连续计分,检查是否遗漏禁用 Body 或领取状态保护。

拾取类对象应以重叠检测承载触发逻辑,以一次性状态记录承载“是否已经领取”;墙壁和地板等需要物理阻挡的对象才使用 collider。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 Overlap 识别道具触发区

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

登录哪都通