技能介绍

这个技能解决什么问题

在 Phaser 3 里做平台跳跃或俯视角移动时，开发者常陷入两难：自己手写碰撞检测容易漏边、卡墙，而引入 Matter 这类重型引擎又让项目体积和复杂度陡增。Arcade Physics 是 Phaser 内置的轻量引擎，专为 AABB 矩形和圆形体素设计，适合大多数 2D 街机类游戏的移动与碰撞需求。本技能提供从世界配置到碰撞检测的完整操作路径，帮你绕开手动积分位置、帧率无关性、碰撞类别等常见坑。

它的核心能力与关键步骤

1. 启用物理世界：在 Game 或 Scene 配置中设置 physics: { default: 'arcade', arcade: { gravity: {...}, debug: true } }，debug 模式可在开发期显示刚体轮廓与速度向量。

2. 创建刚体：动态精灵用 this.physics.add.sprite(...)，静态平台用 this.physics.add.staticImage(...)，已有对象用 this.physics.add.existing(obj) 挂载。

3. 通过身体驱动位移：用 setVelocity、setAcceleration、gravity、setBounce、setCollideWorldBounds 控制运动，引擎每步自动积分位置，天然帧率无关；直接写 sprite.x 会与引擎冲突并导致穿墙。

4. 处理交互：this.physics.add.collider(a, b) 分离刚体，this.physics.add.overlap(a, b, cb) 仅检测不分离，适合拾取与触发器。

5. 批量管理：this.physics.add.group() 与 staticGroup() 让一次 collider 调用覆盖整组成员。

适用边界与注意点

不适用于：Game 配置、场景结构、资源加载、相机控制——这些属于 phaser-core 范畴；铰链、弹簧、复杂多边形、堆叠刚体应换用 Matter 引擎，Arcade 与 Matter 刚体互不交互。
手感调优（固定步长、隧穿、抖动）应参考 physics-tuning 技能。
常见陷阱：用 this.add.sprite 而非 this.physics.add.sprite 会导致精灵无刚体；对角线速度比单轴更快，需归一化向量；静态刚体移动后需调用 body.updateFromGameObject() 同步碰撞数据；collider 应在 create 中注册一次而非每帧重复注册。