用途:为 Phaser 游戏加入轻量的 Arcade Physics 物理效果,适用于俯视角或平台跳跃的移动、速度、加速度、重力、弹跳、世界边界,以及精灵、组、瓦片之间的碰撞与重叠处理。目标为 Phaser 4.2 新项目,修改已有项目前应先确认已安装的主版本。
主要能力:世界通过 physics: { default: 'arcade', arcade: { gravity, debug } } 启用,debug 打开可查看物理体轮廓与速度向量;用 this.physics.add.sprite(...) 创建动态体,staticImage(...) 创建静态体,或用 this.physics.add.existing(obj) 附着到已有对象;通过 body 的 setVelocity、setAcceleration、gravity、setBounce、setCollideWorldBounds 驱动,引擎每步自动积分位置;用 collider 分离碰撞体,用 overlap 只检测不分离(拾取物、触发器);用 group 或 staticGroup 批量管理,一次 collider 调用处理全部成员;跳跃前可用 body.onFloor() 或 body.blocked.down 判断落地。
使用方式:在游戏或场景配置中启用物理并设置重力,为精灵添加物理体,在 update 中通过输入设置速度、加速度或重力,常见写法包括每帧先 setVelocity(0) 再按方向设置,对角移动需 normalise().scale(speed) 以保持速度一致;平台用 staticGroup 与 collider 注册;碰撞器与重叠应在 create 中注册一次,不要放进 update;子弹等用 group({ maxSize }) 进行对象池复用,用 get 取用并 enableBody。
限制:Arcade 仅支持 AABB 矩形与圆形,缓冲、铰链、弹簧、复杂多边形或刚体堆叠需使用 Matter 物理,两种物理体互不交互;不要直接写 sprite.x/y 移动动态体,以免穿透碰撞器;静态体移动后需 body.updateFromGameObject() 或 refreshBody() 同步;onFloor() 始终为 false 通常是缺少可碰撞目标或重力未开启。游戏配置、场景、资源加载、相机等属于 phaser-core,本技能不覆盖。