游戏引擎 / 系统课时

用 JustDown 识别一次跳跃

用 JustDown 识别一次跳跃

在 Phaser 4.2.1 的 update() 中直接用按住状态执行跳跃,容易在多个帧里反复修改竖直速度。这里把空格键的首次按下转换成一次性跳跃请求,再用角色是否落地决定能否起跳,并通过画面计数验证按住不连跳。

学习目标

  • 区分 key.isDown 的持续状态与 Phaser.Input.Keyboard.JustDown(key) 的单次触发。
  • 在 Arcade Physics 中组合按键边沿与落地判断。
  • 验证长按、松开重按和空中按下时的结果。

识别按住与首次按下

update() 会持续运行;若在其中用 key.isDown 调用 setVelocityY(-360),按住空格就会反复覆盖重力产生的速度,角色可能异常上升。把落地条件加进去仍不够:一直按住到再次落地时,可能又跳起来。

检查方式 按住空格的表现 适合操作
key.isDown 每次检查都可能为 true 持续移动、蓄力
Phaser.Input.Keyboard.JustDown(key) 同一次按下最多返回一次 true 跳跃、开火、确认
Phaser.Input.Keyboard.JustUp(key) 每次松开最多返回一次 true 松手结算、结束蓄力

JustDown 会在读取时消费按下边沿,不会为同一次按住持续产出请求。把结果保存在 pressed 变量中,再交给落地判断;不要在同一帧的多个 if 中对同一个 Key 重复调用它。

JustDown 按下边沿与落地跳跃决策流程

构建可运行的跳跃场景

准备已安装 Node.js 和 npm 的环境,新建 Vite 原生 JavaScript 项目并固定 Phaser 版本:

bash
npm create vite@latest phaser-jump -- --template vanilla
cd phaser-jump
npm install
npm install phaser@4.2.1

预期结果:项目中存在 index.html 和 src/main.js,依赖包含 phaser@4.2.1。若目录已存在,请改用新目录名以免覆盖文件。

把 src/main.js 完整替换为下面内容。矩形角色和地面由程序生成,不需要准备图片资源:

js
import Phaser from 'phaser';

class JumpScene extends Phaser.Scene {
  constructor() {
    super('JumpScene');
  }

  create() {
    const ground = this.add.rectangle(320, 420, 640, 40, 0x334155);
    this.physics.add.existing(ground, true);

    this.player = this.add.rectangle(160, 320, 36, 48, 0x0d9488);
    this.physics.add.existing(this.player);
    this.player.body.setCollideWorldBounds(true);
    this.physics.add.collider(this.player, ground);

    this.jumpKey = this.input.keyboard.addKey(
      Phaser.Input.Keyboard.KeyCodes.SPACE
    );
    this.jumpCount = 0;
    this.counter = this.add.text(16, 16, '有效跳跃:0', {
      fontSize: '20px',
      color: '#1f2937'
    });
    this.add.text(16, 48, '按空格跳跃,松开后才能再次触发', {
      fontSize: '16px',
      color: '#475569'
    });
  }

  update() {
    // 无论是否着地都消费新按下的边沿,避免空中按住后落地自动起跳。
    const pressed = Phaser.Input.Keyboard.JustDown(this.jumpKey);
    // 仅在地面碰撞有效时给出一次向上的初速度。
    if (pressed && this.player.body.blocked.down) {
      this.player.body.setVelocityY(-360);
      this.jumpCount += 1;
      this.counter.setText(`有效跳跃:${this.jumpCount}`);
    }
  }
}

new Phaser.Game({
  type: Phaser.AUTO,
  width: 640,
  height: 480,
  parent: 'app',
  backgroundColor: '#f8fafc',
  physics: {
    default: 'arcade',
    arcade: { gravity: { x: 0, y: 800 }, debug: false }
  },
  scene: JumpScene
});

预期结果:画布显示青绿色矩形角色、深色地面与“有效跳跃:0”。角色先落在地面上;此后每次有效按键使竖直速度变为 -360 像素/秒,重力为 800 像素/秒²,计数增加一次。Phaser 屏幕坐标向下为正,因此负的 velocity.y 表示向上。

运行并检验输入边界

在项目目录启动开发服务器:

bash
npm run dev

预期输出(版本、耗时及端口随环境变化):

text
VITE v<VERSION> ready in <TIME> ms
Local: http://localhost:<PORT>/

打开终端给出的地址,等待角色落地,再依次测试:

  1. 短按空格一次:角色跳起后落下,计数从 0 变为 1。
  2. 按住空格直到再次落地:只跳一次,计数停在 1;不会在落地时自动连跳。
  3. 松开再按:会再次跳跃,计数变为 2。
  4. 角色腾空时松开并重新按下,然后保持按住:这次空中请求被消费且未执行;落地不会补跳,必须再次松开重按。

持续移动应使用 isDown;跳跃这类离散动作使用 JustDown,并在同一次读取后再检查游戏规则。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 JustDown 识别一次跳跃

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

登录哪都通