游戏客户端架构 / 系统课时
设计Action与Binding数据结构
设计Action与Binding数据结构
输入系统如果把“按键”“手柄轴”“玩法动作”混在同一个结构里,后续做改键、多设备适配和冲突检测都会变得困难。本节把动作语义与物理输入拆开,设计一套既能表达按钮,也能表达轴与修饰键的最小数据结构。
学习目标
- 区分
Action与Binding的职责,避免玩法逻辑依赖具体设备。 - 设计动作标识、设备、修饰键、轴参数等必要字段。
- 用一份可运行示例验证多个 Binding 如何汇聚到同一个 Action。
先把动作语义和物理输入分开
Action 表示“玩家想做什么”,例如跳跃、冲刺、移动;Binding 表示“哪个设备上的什么输入触发这个动作”。同一个 Action 可以拥有多个 Binding,例如键盘空格与手柄南键都触发 jump。
这种拆分的关键价值是:玩法代码只监听 jump、moveX 这样的动作,不需要知道它来自键盘还是手柄。改键时只修改 Binding 配置,不改玩法代码。

字段只保留运行时真正需要的语义
一个实用的最小模型通常需要这些字段:动作唯一标识、绑定唯一标识、设备类型、控件标识、修饰键,以及轴输入的缩放和死区。按钮类输入不需要轴参数时,可以让这些字段保持默认值。
下面的 TypeScript 示例同时覆盖数字动作和模拟轴动作,并包含最小匹配逻辑。
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: []
}));预期输出:
[ { 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 只表达物理输入与转换规则时,输入系统才能自然支持多设备、改键和配置覆盖,而不让玩法层感知具体硬件。