游戏客户端架构 / 系统课时

设计Action与Binding数据结构

设计Action与Binding数据结构

输入系统如果把“按键”“手柄轴”“玩法动作”混在同一个结构里,后续做改键、多设备适配和冲突检测都会变得困难。本节把动作语义与物理输入拆开,设计一套既能表达按钮,也能表达轴与修饰键的最小数据结构。

学习目标

  • 区分 Action 与 Binding 的职责,避免玩法逻辑依赖具体设备。
  • 设计动作标识、设备、修饰键、轴参数等必要字段。
  • 用一份可运行示例验证多个 Binding 如何汇聚到同一个 Action。

先把动作语义和物理输入分开

Action 表示“玩家想做什么”,例如跳跃、冲刺、移动;Binding 表示“哪个设备上的什么输入触发这个动作”。同一个 Action 可以拥有多个 Binding,例如键盘空格与手柄南键都触发 jump。

这种拆分的关键价值是:玩法代码只监听 jump、moveX 这样的动作,不需要知道它来自键盘还是手柄。改键时只修改 Binding 配置,不改玩法代码。

Action 与 Binding 的关系

字段只保留运行时真正需要的语义

一个实用的最小模型通常需要这些字段:动作唯一标识、绑定唯一标识、设备类型、控件标识、修饰键,以及轴输入的缩放和死区。按钮类输入不需要轴参数时,可以让这些字段保持默认值。

下面的 TypeScript 示例同时覆盖数字动作和模拟轴动作,并包含最小匹配逻辑。

ts
type DeviceType = "keyboard" | "gamepad";

interface Action {
  id: string;
  kind: "button" | "axis1d";
}

interface Binding {
  id: string;
  actionId: string;
  device: DeviceType;
  control: string;
  modifiers?: string[];
  scale?: number;
  deadZone?: number;
}

interface InputEvent {
  device: DeviceType;
  control: string;
  value: number;
  pressedModifiers: string[];
}

const actions: Action[] = [
  { id: "jump", kind: "button" },
  { id: "moveX", kind: "axis1d" }
];

const bindings: Binding[] = [
  { id: "jump-space", actionId: "jump", device: "keyboard", control: "Space" },
  { id: "jump-pad-a", actionId: "jump", device: "gamepad", control: "ButtonSouth" },
  { id: "move-left-stick-x", actionId: "moveX", device: "gamepad", control: "LeftStickX", scale: 1, deadZone: 0.15 }
];

function resolve(event: InputEvent): { actionId: string; value: number }[] {
  return bindings.flatMap((binding) => {
    if (binding.device !== event.device || binding.control !== event.control) {
      return [];
    }

    const required = binding.modifiers ?? [];
    if (!required.every((m) => event.pressedModifiers.includes(m))) {
      return [];
    }

    const deadZone = binding.deadZone ?? 0;
    const scaled = Math.abs(event.value) < deadZone ? 0 : event.value * (binding.scale ?? 1);
    return [{ actionId: binding.actionId, value: scaled }];
  });
}

console.log(resolve({
  device: "keyboard",
  control: "Space",
  value: 1,
  pressedModifiers: []
}));

console.log(resolve({
  device: "gamepad",
  control: "LeftStickX",
  value: 0.6,
  pressedModifiers: []
}));

预期输出:

text
[ { actionId: 'jump', value: 1 } ]
[ { actionId: 'moveX', value: 0.6 } ]

如果运行环境或打印格式不同,引号与空格可能略有差异,但动作标识和值应一致。

轴参数不要塞进 Action

deadZone、scale 这类参数描述的是“某个物理输入如何转换成动作值”,因此应该属于 Binding,而不是 Action。否则同一个 moveX 同时绑定键盘 A/D、手柄摇杆和方向盘时,会被迫共享并不适用的参数。

修饰键同理。Ctrl+K 与单独的 K 是两条不同 Binding;不要把 Ctrl 写进动作名,否则动作语义会被设备细节污染。

给标识符设稳定边界

Action.id 应该稳定并面向玩法,例如 jump、openInventory;不要使用 Space、ButtonSouth 这类设备名称。Binding.id 则用于覆盖、禁用和保存玩家设置,最好也是稳定字符串,而不是依赖数组下标。

当 Action 只表达玩法语义、Binding 只表达物理输入与转换规则时,输入系统才能自然支持多设备、改键和配置覆盖,而不让玩法层感知具体硬件。

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

目录与阅读设置

阅读设置

17

记录一个想法

设计Action与Binding数据结构

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

登录哪都通