游戏引擎 / 系统课时
用 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 会加载该入口。
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) 会隐藏图形,却不会自动关闭物理碰撞。

本例只有一件道具,因此使用一个场景级布尔值。若一关有十枚金币,不要共用同一个 pickedUp:应给每枚道具分别记录领取状态,或在领取回调中立即禁用对应道具的 Body,否则拾取第一枚后可能让其余金币也失效。
验证触发和定位异常
运行 npm run dev,在终端显示的本地地址打开页面;实际端口可能不同。按住右方向键约两秒,让玩家从横坐标 100 附近移动到道具所在的 540 附近,检查以下结果:
- 接触前计数为 0;接触后只增加到 1,道具立即消失。
- 继续按住右键,玩家仍可经过原道具位置,分数不会增加到 2。
- 按左键返回原位置,再穿过一次,分数依然是 1。
如果道具可见却不能拾取,先检查配置中 physics.default 是否为 arcade、双方是否都执行了 this.physics.add.existing,再临时把 debug: false 改为 debug: true,查看物理体边框是否处于预期位置。若玩家被挡住,检查是不是把触发器误注册成 this.physics.add.collider;若隐藏后仍连续计分,检查是否遗漏禁用 Body 或领取状态保护。
拾取类对象应以重叠检测承载触发逻辑,以一次性状态记录承载“是否已经领取”;墙壁和地板等需要物理阻挡的对象才使用 collider。