游戏引擎 / 系统课时

配置 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 启动。示例直接绘制矩形,不需要预加载图片。

js
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):

text
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 世界边界与动态体、静态体的空间关系

检查配置失效的原因

如果看不到调试轮廓,先检查 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,保留必要的重力、边界与碰撞器配置。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置 Arcade Physics 世界

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

登录哪都通