游戏引擎 / 系统课时
用 Collider 阻挡墙体和平台
用 Collider 阻挡墙体和平台
角色与墙体同屏出现,并不意味着物理系统会自动阻挡。本课以 Phaser 4.2.1 建立动态角色、静态地面与墙体之间的 Collider,做出可移动、可跳跃的碰撞演示,并学会区分碰撞回调、视觉外形和实际刚体边界。
学习目标
- 正确创建动态刚体、静态刚体,并用 Collider 实现阻挡。
- 知道碰撞回调何时执行,以及
collider与overlap的区别。 - 使用调试边框、
setSize和接地方向检查碰撞是否正确。
Collider 如何让角色停在平台上
Arcade Physics 只对拥有物理刚体(Body)的对象做碰撞检测。角色需要受重力和速度影响,使用动态 Body;墙体、地面与固定平台不应被推走,使用静态 StaticBody。仅把矩形画在画布上,双方仍然可以穿过彼此。
this.physics.add.collider(a, b) 会注册持续检查:每个物理步检测双方刚体是否相交,必要时分离并调整运动状态。如果只检测接触而不阻挡,例如拾取金币,应使用 this.physics.add.overlap(a, b)。Collider 的第三个参数可以接收碰撞回调,但不传回调也会产生阻挡。

搭建可运行的阻挡场景
准备 Node.js 和 npm。以下以 Vite 的 Vanilla JavaScript 模板作为最小工程,不依赖图片素材;地面、墙体与角色都用矩形绘制。终端依次执行:
npm create vite@latest collider-demo -- --template vanilla
cd collider-demo
npm install
npm install phaser@4.2.1
npm run dev预期输出(节选,端口可能不同):
Local: http://localhost:<PORT>/<PORT> 是开发服务器分配的端口,以终端实际地址为准。将工程中的 src/main.js 完整替换为以下代码;模板自带的 index.html 已有 id="app" 的挂载元素,无需准备额外素材。
import Phaser from 'phaser';
class CollisionScene extends Phaser.Scene {
constructor() {
super('CollisionScene');
}
create() {
this.add.text(16, 12, '← → 移动,↑ 跳跃', {
fontSize: '18px', color: '#1f2937'
});
this.status = this.add.text(16, 42, '最近碰撞:无', {
fontSize: '16px', color: '#0f766e'
});
this.player = this.add.rectangle(130, 180, 40, 56, 0x0d9488);
this.physics.add.existing(this.player);
// 角色视觉为 40×56,碰撞框缩到 32×52 并居中
this.player.body.setSize(32, 52);
this.player.body.setCollideWorldBounds(true);
const floor = this.add.rectangle(400, 570, 800, 60, 0x64748b);
const platform = this.add.rectangle(280, 420, 220, 24, 0x64748b);
const wall = this.add.rectangle(640, 460, 28, 160, 0xf59e0b);
const obstacles = [floor, platform, wall];
// 固定地形采用静态刚体,不受重力及碰撞推挤
for (const obstacle of obstacles) {
this.physics.add.existing(obstacle, true);
obstacle.body.updateFromGameObject();
}
this.physics.add.collider(this.player, obstacles, (player, obstacle) => {
const label = obstacle === wall ? '墙体' :
obstacle === platform ? '高台' : '地面';
// 持续接触会重复回调,这里只更新提示,不反复扣血
this.status.setText(`最近碰撞:${label}`);
});
this.cursors = this.input.keyboard.createCursorKeys();
}
update() {
const body = this.player.body;
body.setVelocityX(this.cursors.left.isDown ? -190 :
this.cursors.right.isDown ? 190 : 0);
if (Phaser.Input.Keyboard.JustDown(this.cursors.up) &&
body.blocked.down) {
body.setVelocityY(-520);
}
}
}
new Phaser.Game({
type: Phaser.AUTO,
parent: 'app',
width: 800,
height: 600,
backgroundColor: '#f8fafc',
physics: {
default: 'arcade',
arcade: { gravity: { x: 0, y: 900 }, debug: true }
},
scene: CollisionScene
});预期结果:打开开发服务器地址,青绿色角色自动落到灰色地面;用左右方向键以 190 像素/秒移动,按上方向键在着地时跳跃。跳到左侧高台后可站稳,走到右侧橙色墙体前会被挡住。左上角的“最近碰撞”会在接触对象变化时更新,调试线框显示实际物理范围。
分清碰撞回调与接触方向
collider 的回调参数是参与碰撞的两个游戏对象,示例通过第二个对象识别地面、高台或墙体。它不是“首次接触事件”:角色停在平台上时,回调可能连续多次触发,因此不能直接在其中每次扣除生命值。需要一次性触发效果时,应自行记录上一帧的接触状态并检测从未接触到接触的变化。
本例用 body.blocked.down 判断角色是否被静态地形或世界边界向下阻挡,只有此时按下上方向键才允许跳跃。body.touching 提供当前物理步的接触方向,body.wasTouching 保存上一步的信息;它们都不是碰撞回调次数。不要把视觉上“脚碰到平台”当成着地条件,也不要只看 player.y 判断。
对齐刚体并排查穿墙
物理检测依据 Body 的矩形,不依据绘制颜色或透明区域。示例中的角色显示范围为 40×56,但 setSize(32, 52) 将物理框设得更窄、更矮;打开 debug: true 后,应该能看到线框与角色边缘之间的空隙。这说明碰撞回调正确触发,也不代表两张可见图形的边缘恰好贴合。
遇到异常时按下列顺序检查:
- 角色穿过平台:确认双方调用过
physics.add.existing,并且调用的是physics.add.collider,不是overlap;静态物体应传入true。 - 角色悬空或陷入边缘:检查
body.setSize(width, height)与body.setOffset(x, y),对照调试线框修正,而不是盲目改角色坐标。 - 移动平台后挡板仍在原处:静态 Body 不会随游戏对象的位置、缩放自动同步。修改后调用该对象的
body.updateFromGameObject();会持续移动的平台通常应另选合适的动态刚体方案。 - 接触后回调刷屏:这是持续碰撞检测的正常结果。只在状态切换时播放音效、扣血或生成粒子,不要把每次回调当成一次新撞击。
最后进行三次验收:角色自由落下时被地面接住;水平移动时在墙体外侧停止;从地面跳上高台后不会穿透,并且调试线框与预期的碰撞区域一致。完成这些检查后,再把 debug 改为 false 用于正常游戏画面。