游戏引擎 / 系统课时
用 velocity 控制刚体运动
用 velocity 控制刚体运动
通过 Arcade Physics 的水平速度,让一个物理精灵按方向键匀速移动、切换方向,并在松键后立即停下。示例基于 Phaser 4.2.1,使用程序生成的方块纹理,不依赖外部图片;运行后还能直接看到当前设定的速度值。
学习目标
- 读懂
velocity.x的正负方向及像素/秒单位。 - 使用
setVelocityX()完成左移、右移和松键停止。 - 根据位移估算与画面反馈,排查速度设置中的常见错误。
速度值表示什么
Arcade Physics 的动态刚体保存着 body.velocity,其中 x、y 的单位都是像素/秒(px/s)。在默认屏幕坐标中,X 轴向右为正,Y 轴向下为正。对水平角色来说,setVelocityX(180) 表示向右每秒约 180 像素,setVelocityX(-180) 表示向左,setVelocityX(0) 表示停止水平运动。
在没有碰撞、水平加速度或其他干预时,水平位移可按“速度 × 时间”估算:保持 180 px/s 移动 0.5 秒,约前进 90 像素。Arcade Physics 会在物理步中按经过的时间积分位移,因此不要把 180 当成每帧移动 180 像素,也不要再乘一次 update() 的 delta。
setVelocityX() 仅改变 X 轴速度,不会清除 Y 轴速度。这点在后续加入跳跃时尤其有用:松开左右键只应停止水平移动,不应让角色在空中突然停止升降。
创建可运行的移动示例
准备 Node.js、npm 和支持 WebGL 的浏览器。先创建一个 Vite 原生 JavaScript 工程并安装 Phaser 4.2.1:
# 使用 Vite 的原生 JavaScript 模板建立独立工程
npm create vite@latest arcade-velocity -- --template vanilla
cd arcade-velocity
npm install
# 固定 Phaser 版本,启动本地开发服务器
npm install phaser@4.2.1
npm run dev预期输出(节选;Vite 版本、启动耗时和端口以本机为准):
VITE v<VERSION> ready in <TIME> ms
Local: http://localhost:<PORT>/保持开发服务器运行,将 src/main.js 全部替换为以下代码。Vite 模板的 index.html 已包含 id="app" 的容器,无需额外加载素材:
import Phaser from 'phaser';
class VelocityScene extends Phaser.Scene {
constructor() {
super('VelocityScene');
}
create() {
// 生成 36×36 的纹理,避免示例依赖图片文件
const graphics = this.add.graphics();
graphics.fillStyle(0x0f766e, 1);
graphics.fillRect(0, 0, 36, 36);
graphics.generateTexture('player', 36, 36);
graphics.destroy();
// 创建带动态刚体的精灵,而不是普通显示对象
this.player = this.physics.add.sprite(400, 225, 'player');
this.player.setCollideWorldBounds(true);
this.keys = this.input.keyboard.createCursorKeys();
this.status = this.add.text(12, 12, '', {
fontSize: '18px',
color: '#1f2937'
});
}
update() {
const left = this.keys.left.isDown;
const right = this.keys.right.isDown;
// 两键同按或都松开时,明确设为零,防止保留旧速度
const vx = left === right ? 0 : (left ? -180 : 180);
// 只更新水平轴,避免意外中断竖直跳跃
this.player.setVelocityX(vx);
this.status.setText(`velocity.x = ${this.player.body.velocity.x} px/s`);
}
}
new Phaser.Game({
type: Phaser.AUTO,
parent: 'app',
width: 800,
height: 450,
backgroundColor: '#ffffff',
physics: {
default: 'arcade',
arcade: { gravity: { x: 0, y: 0 }, debug: false }
},
scene: VelocityScene
});预期结果:浏览器打开终端显示的 Local 地址,画面出现白底、青绿色方块和左上角速度读数。按左键时读数为 -180 px/s,按右键为 180 px/s,松开或同时按住两键时为 0 px/s;方块到达画布边缘会被世界边界挡住。
验证方向、位移与停下
从画布中央开始,按右键约 0.5 秒再松开,方块理论上从 x=400 移动到 x≈490;按左键同样长的时间,理论上会向左约 90 像素。手动计时、键盘采样与物理步进会产生少量误差,因此不要求像素级吻合。
| 输入状态 | 设定的 X 速度 | 可见行为 |
|---|---|---|
| 仅按左键 | -180 px/s | 向左匀速移动 |
| 仅按右键 | +180 px/s | 向右匀速移动 |
| 两键都松开 | 0 px/s | 下一物理步停止水平位移 |
| 两键同时按下 | 0 px/s | 不在两方向间反复抖动 |
示例把世界重力设置为 0,是为了只观察水平速度;setCollideWorldBounds(true) 负责限制刚体不越过 800×450 的世界边界。当方块抵住左右边缘时,位移会被碰撞约束,即使按键仍请求 180 或 -180,也不能继续穿出画布。请在远离边界的位置测量位移。
常见错误与正确处理
直接在 update() 中写 player.x += 180,含义是每帧加 180 像素,而且绕过了 Arcade Physics 的速度积分与碰撞更新。正确做法是设置 setVelocityX(180),让物理世界推进刚体;除非有意瞬移,否则不要同时手动修改坐标与物理速度。
若按键松开后角色仍滑行,首先检查 update() 是否每帧都走到 setVelocityX(0) 的分支。只在 keydown 时设置速度、却不在松键后清零,就会保留旧值。示例通过每帧计算目标速度解决了这个问题。
也不要把单轴停止误写成 setVelocity(0, 0):它会把竖直速度一并清除。在有重力、跳跃或击退的项目中,只处理水平输入时应使用 setVelocityX(0);需要同时停住两轴时,才明确使用 setVelocity(0, 0)。本例的即时变向适合街机式操作,若想要惯性起步和减速,再考虑加速度、阻力与速度上限。