《Cocos 游戏开发入门》5.3 输入缓冲与手感

// src/input/timed-buffer.ts
export class TimedBuffer {
  private readonly window: number;
  private stamp = Number.NEGATIVE_INFINITY;

  constructor(window: number) {
    this.window = window;
  }

  /** 记录一次输入发生（单位：秒） */
  press(now: number): void {
    this.stamp = now;
  }

  /** 在窗口内消费：成功返回 true 并清空，过期返回 false */
  consume(now: number): boolean {
    if (now - this.stamp <= this.window) {
      this.stamp = Number.NEGATIVE_INFINITY;
      return true;
    }
    return false;
  }

  get pending(): boolean {
    return this.stamp !== Number.NEGATIVE_INFINITY;
  }
}

// src/input/feel-config.ts
export interface FeelConfig {
  /** 跳跃缓冲窗口：落地前多久按下仍算数（秒） */
  jumpBuffer: number;
  /** 土狼时间：离地后多久内仍可跳（秒） */
  coyoteTime: number;
  /** 连击窗口：多久内再次攻击算连击（秒） */
  comboWindow: number;
}

export const DEFAULT_FEEL: FeelConfig = {
  jumpBuffer: 0.12,
  coyoteTime: 0.10,
  comboWindow: 0.35,
};

// src/game/jump-controller.ts
import { TimedBuffer } from "../input/timed-buffer";
import { FeelConfig } from "../input/feel-config";

export class JumpController {
  private readonly cfg: FeelConfig;
  private readonly buffer: TimedBuffer;
  private lastGroundedAt = Number.NEGATIVE_INFINITY;

  constructor(cfg: FeelConfig) {
    this.cfg = cfg;
    this.buffer = new TimedBuffer(cfg.jumpBuffer);
  }

  /** 玩家按下跳跃键时调用 */
  onJumpPressed(now: number): void {
    this.buffer.press(now);
  }

  /** 每帧调用；grounded 表示角色当前是否踩在地面 */
  update(now: number, grounded: boolean): boolean {
    if (grounded) this.lastGroundedAt = now;
    const withinCoyote = now - this.lastGroundedAt <= this.cfg.coyoteTime;
    if ((grounded || withinCoyote) && this.buffer.consume(now)) {
      // 起跳后立刻作废土狼时间，防止刚跳就二段跳
      this.lastGroundedAt = Number.NEGATIVE_INFINITY;
      return true;
    }
    return false;
  }
}

// src/game/combo-tracker.ts
export class ComboTracker {
  private readonly window: number;
  private lastHitAt = Number.NEGATIVE_INFINITY;
  private count = 0;

  constructor(window: number) {
    this.window = window;
  }

  /** 每次攻击命中调用，返回当前连击数 */
  hit(now: number): number {
    if (now - this.lastHitAt <= this.window) {
      this.count += 1;
    } else {
      this.count = 1;
    }
    this.lastHitAt = now;
    return this.count;
  }

  get current(): number {
    return this.count;
  }
}

// test/feel.test.ts
import { describe, it, expect } from "vitest";
import { JumpController } from "../src/game/jump-controller";
import { ComboTracker } from "../src/game/combo-tracker";
import { DEFAULT_FEEL } from "../src/input/feel-config";

describe("跳跃缓冲与土狼时间", () => {
  it("落地前 80ms 按下，落地瞬间自动起跳", () => {
    const c = new JumpController(DEFAULT_FEEL);
    c.onJumpPressed(0.90);
    expect(c.update(0.95, false)).toBe(false);  // 仍在空中
    expect(c.update(1.00, true)).toBe(true);    // 落地即消费缓冲
  });

  it("刚离地 80ms 内仍可跳（土狼时间）", () => {
    const c = new JumpController(DEFAULT_FEEL);
    c.update(0.00, true);
    c.update(0.05, false);
    c.onJumpPressed(0.08);
    expect(c.update(0.08, false)).toBe(true);
  });

  it("离地超过土狼时间就跳不了", () => {
    const c = new JumpController(DEFAULT_FEEL);
    c.update(0.00, true);
    c.update(0.30, false);
    c.onJumpPressed(0.30);
    expect(c.update(0.30, false)).toBe(false);
  });

  it("缓冲过期后不再起跳", () => {
    const c = new JumpController(DEFAULT_FEEL);
    c.onJumpPressed(0.00);
    expect(c.update(0.50, true)).toBe(false);   // 0.5s 远超 0.12s 窗口
  });
});

describe("连击窗口", () => {
  it("窗口内连击累加，超时后归零重计", () => {
    const combo = new ComboTracker(DEFAULT_FEEL.comboWindow);
    expect(combo.hit(0.00)).toBe(1);
    expect(combo.hit(0.30)).toBe(2);
    expect(combo.hit(0.60)).toBe(3);
    expect(combo.hit(1.20)).toBe(1);   // 距上次 0.6s，超窗口
  });
});

import {
  _decorator, Component, Node, input, Input, EventKeyboard, KeyCode,
} from 'cc';

const { ccclass } = _decorator;

@ccclass('JumpInputBridge')
export class JumpInputBridge extends Component {
  private readonly buffer = { stamp: Number.NEGATIVE_INFINITY, window: 0.12 };

  onEnable(): void {
    input.on(Input.EventType.KEY_DOWN, this.onKeyDown, this);
    this.node.on(Node.EventType.TOUCH_START, this.onTouchStart, this);
  }
  onDisable(): void {
    input.off(Input.EventType.KEY_DOWN, this.onKeyDown, this);
    this.node.off(Node.EventType.TOUCH_START, this.onTouchStart, this);
  }

  private onKeyDown(event: EventKeyboard): void {
    if (event.keyCode === KeyCode.SPACE || event.keyCode === KeyCode.KEY_W) {
      this.buffer.stamp = performance.now() / 1000;
    }
  }
  private onTouchStart(): void {
    this.buffer.stamp = performance.now() / 1000;
  }
}