游戏引擎 / 系统课时
配置 Arcade Physics 世界
配置 Arcade Physics 世界
这一课在 Phaser 4.2.1 中启用 Arcade Physics,设定重力、调试显示和物理世界边界,并用一个无需外部图片的落地场景验证配置。完成后,你能区分动态体、静态体以及两种不同的碰撞约束。
学习目标
- 在 Game 配置中启用 Arcade Physics,明确重力、边界与调试开关的作用。
- 创建受重力影响的动态体和固定不动的静态体,让方块落在平台上。
- 根据调试轮廓与控制台输出判断世界配置、边界碰撞是否生效。
配置物理世界
Arcade Physics 适合平台跳跃、俯视移动等以矩形或圆形碰撞体为主的游戏。它不模拟复杂的刚体形状和关节。配置入口是 new Phaser.Game(config) 的 physics 字段;设置 default: 'arcade' 后,Scene 内才能通过 this.physics 访问对应物理插件。
以 800×600 的逻辑游戏区域为例,先统一使用下列数值。这里的重力单位是像素每秒平方,不是“每帧移动 500 像素”。
| 配置项 | 示例值 | 作用 |
|---|---|---|
physics.default |
'arcade' |
启用 Arcade 物理系统 |
arcade.gravity |
{ x: 0, y: 500 } |
动态体持续向下加速 |
arcade.debug |
true |
开发时绘制碰撞体和速度的调试信息 |
arcade.x/y/width/height |
0/0/800/600 |
设置物理世界的矩形边界 |
世界边界与画布尺寸可以不同:画布决定显示区域,world.bounds 决定物理约束所在的矩形。下例刻意让二者一致,避免初次调试时把摄像机可见区域误认为物理边界。
运行最小落地场景
前提是已有使用 ES Module 的 Vite JavaScript 工程,并安装了 phaser@4.2.1。将以下完整示例保存为 src/main.js,通过项目的 npm run dev 启动。示例直接绘制矩形,不需要预加载图片。
import Phaser from 'phaser';
class PhysicsScene extends Phaser.Scene {
constructor() {
super('PhysicsScene');
}
create() {
const ball = this.add.rectangle(400, 80, 36, 36, 0x14b8a6);
this.physics.add.existing(ball); // 为可见矩形创建动态体
ball.body.setCollideWorldBounds(true);
ball.body.setBounce(0);
const floor = this.add.rectangle(400, 570, 760, 40, 0x475569);
this.physics.add.existing(floor, true); // 静态体不受重力推动
this.physics.add.collider(ball, floor);
console.log(`world=${this.physics.world.bounds.width}x${this.physics.world.bounds.height}`);
console.log(`dynamic=${ball.body instanceof Phaser.Physics.Arcade.Body}`);
console.log(`static=${floor.body instanceof Phaser.Physics.Arcade.StaticBody}`);
}
}
new Phaser.Game({
type: Phaser.AUTO,
width: 800,
height: 600,
backgroundColor: '#ffffff',
physics: {
default: 'arcade',
arcade: {
gravity: { x: 0, y: 500 },
debug: true,
x: 0, y: 0, width: 800, height: 600
}
},
scene: PhysicsScene
});预期输出(浏览器开发者工具 Console):
world=800x600
dynamic=true
static=true页面中,青绿色方块从 (400, 80) 向下运动,落到深蓝灰平台上并停止;开启调试后,能看到物理体轮廓。由于配置了 setBounce(0),落地不应持续弹跳。刷新页面可以重复观察下落过程。
区分世界边界与平台碰撞
this.physics.add.existing(ball) 创建的是 动态体:它会依据世界重力和速度更新位置。this.physics.add.existing(floor, true) 创建的是 静态体:它可参与碰撞,但不会被重力、速度或碰撞结果推动。平台不必做成动态体再设置速度为零。
世界边界本身是一个不可见矩形,不会自动挡住所有对象。ball.body.setCollideWorldBounds(true) 只让这个动态体与世界边缘发生阻挡;this.physics.add.collider(ball, floor) 则单独注册方块和地面之间的持续碰撞检测与分离。删掉后者,方块会穿过平台,直到触及启用的世界下边界。

检查配置失效的原因
如果看不到调试轮廓,先检查 arcade.debug 是否为 true,再确认使用的是 this.physics.add.existing() 而不只是 this.add.rectangle()。普通 Game Object 不会因为全局启用了 Arcade 就自动拥有物理体;可以检查 ball.body 是否存在。
如果方块穿过平台,优先确认是否执行了 this.physics.add.collider(ball, floor),并检查两个 Body 是否处于启用状态。如果仅在世界边缘穿出画面,应检查该动态体的 setCollideWorldBounds(true) 以及 world.bounds 的实际宽高,而不是误以为所有可见对象都自动受边界约束。
静态体创建之后若修改了对象位置或缩放,物理体边框可能仍停在旧位置;调整完调用 floor.body.updateFromGameObject() 同步尺寸与位置,再看调试轮廓是否对齐。正式发布时把 debug 改为 false,保留必要的重力、边界与碰撞器配置。