游戏客户端架构 / 系统课时
用统一事件模型描述按钮与轴
用统一事件模型描述按钮与轴
键盘、鼠标、手柄和触屏上报的数据形态差异很大。本节把它们收敛成少量稳定的事件类型,让上层玩法只关心“发生了什么输入”,而不再直接依赖具体设备 API。
学习目标
- 设计能同时表达按钮、连续轴、指针和触摸的统一事件模型
- 理解统一模型中设备信息、控件标识、数值与位置字段各自的职责
- 能把不同设备的原始输入规范化后交给同一套玩法逻辑
为什么要先统一输入表达
如果玩法代码直接读取 Keyboard、Gamepad、Mouse 和触屏事件,设备差异会迅速渗透到移动、交互、菜单等逻辑中。后续新增手柄布局或移动端控制时,往往只能继续增加条件分支。
更稳定的做法是增加一层“输入规范化”:设备层负责读取原始事件,规范化层把它们转换为统一事件,上层再根据事件语义决定玩法行为。这样设备差异只集中在边界处。

用判别联合表达不同事件
统一模型不等于把所有字段塞进一个大对象。更适合的方式是使用带 kind 的判别联合:公共字段保持一致,每类事件只携带自己真正需要的数据。
type DeviceKind = "keyboard" | "mouse" | "gamepad" | "touch";
type InputEvent =
| {
kind: "button";
device: DeviceKind;
control: string;
pressed: boolean;
}
| {
kind: "axis";
device: DeviceKind;
control: string;
value: number;
}
| {
kind: "pointer";
device: DeviceKind;
control: string;
x: number;
y: number;
};
function normalize(raw: { device: DeviceKind; type: string; code: string; value?: number; x?: number; y?: number }): InputEvent {
if (raw.type === "button") {
return {
kind: "button",
device: raw.device,
control: raw.code,
pressed: (raw.value ?? 0) > 0
};
}
if (raw.type === "axis") {
return {
kind: "axis",
device: raw.device,
control: raw.code,
value: raw.value ?? 0
};
}
return {
kind: "pointer",
device: raw.device,
control: raw.code,
x: raw.x ?? 0,
y: raw.y ?? 0
};
}
const events = [
normalize({ device: "keyboard", type: "button", code: "Space", value: 1 }),
normalize({ device: "gamepad", type: "axis", code: "LeftStickX", value: 0.75 }),
normalize({ device: "touch", type: "pointer", code: "PrimaryTouch", x: 320, y: 180 })
];
for (const event of events) {
console.log(JSON.stringify(event));
}预期输出:
{"kind":"button","device":"keyboard","control":"Space","pressed":true}
{"kind":"axis","device":"gamepad","control":"LeftStickX","value":0.75}
{"kind":"pointer","device":"touch","control":"PrimaryTouch","x":320,"y":180}示例中的 control 是规范化后的控件标识,不要求直接等同于某个平台的原始键码。真正接入引擎时,可以在设备适配层把原始键、摇杆轴或触点映射成项目内部稳定的名称。
按钮、轴和位置数据不要混成一种数值
按钮是离散输入,核心是按下或释放;轴是连续输入,通常需要保留 -1 到 1 或其他连续范围;指针和触摸位置则属于二维坐标。三者虽然都能最终影响玩法,但数据语义不同。
如果强行只保留一个 value 字段,上层就必须根据控件名称猜测数值含义,例如 1 到底代表“按下”、摇杆推满还是某个坐标,这会让模型失去类型约束,也容易在重构时引入错误。
什么时候还需要动作映射层
统一事件模型解决的是“设备数据怎么表达”,但玩法通常更希望接收 Jump、MoveX、Confirm 这样的动作,而不是 Space 或 LeftStickX。因此实际项目中常在统一事件之后再增加动作映射层。
例如键盘 Space、手柄 SouthButton 和触屏“跳跃按钮”都可以映射为同一个 Jump 动作。这样设备层、统一事件层和玩法动作层各自负责一个问题:前者接设备,中间层统一数据形态,后者表达游戏意图。
当项目支持多种输入设备时,优先让所有原始输入先进入同一事件模型,再做动作映射;不要让玩法模块分别认识每一种设备。