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

确定输入系统的边界和依赖方向

确定输入系统的边界和依赖方向

输入模块最容易失控的地方,不是采集按键,而是角色、UI、设备 API 互相调用。本节通过明确模块职责和单向依赖,让设备适配可以替换、玩法逻辑可以测试,UI 也不需要认识底层硬件。

学习目标

  • 划清设备适配、输入核心与业务消费者的职责边界
  • 建立从底层设备到高层玩法的单向依赖
  • 用最小代码验证玩法层不依赖具体设备 API

先画清模块边界

可以把输入链路拆成四类职责:设备 API 产生原始事件,适配器把不同平台事件转成统一格式,输入核心完成映射与状态管理,角色和 UI 只消费动作结果。关键约束是依赖只能向“更稳定的抽象”靠拢。

输入系统模块边界与单向依赖

设备适配层可以依赖引擎或操作系统提供的输入 API,因为它的职责就是隔离这些差异。输入核心可以依赖统一事件结构和绑定配置,但不应该知道“玩家角色”“背包面板”或“确认按钮”这些业务对象。玩法和 UI 只认识动作契约。

这条边界的目的不是追求层数,而是让变化停在正确的位置:换手柄驱动只改适配层,改键只改绑定,角色跳跃规则只改玩法层。

让玩法只依赖动作契约

下面的 Node.js 示例用最小结构验证依赖方向。KeyboardAdapter 认识设备键码,InputRouter 负责映射,PlayerController 只认识 Jump 和 Attack,因此玩法层没有任何键盘 API。

js
const bindings = new Map([
  ["Space", "Jump"],
  ["KeyJ", "Attack"],
]);

class KeyboardAdapter {
  toAction(event) {
    if (event.type !== "keydown") return null;
    return bindings.get(event.code) ?? null;
  }
}

class InputRouter {
  constructor(adapters) {
    this.adapters = adapters;
  }

  collect(event) {
    // 输入核心只聚合动作,不调用任何角色或 UI 方法。
    const actions = this.adapters
      .map((adapter) => adapter.toAction(event))
      .filter(Boolean);
    return new Set(actions);
  }
}

class PlayerController {
  update(actions) {
    // 玩法层只依赖稳定的动作语义。
    if (actions.has("Jump")) console.log("player.jump()");
    if (actions.has("Attack")) console.log("player.attack()");
  }
}

const router = new InputRouter([new KeyboardAdapter()]);
const player = new PlayerController();

player.update(router.collect({ type: "keydown", code: "Space" }));
player.update(router.collect({ type: "keydown", code: "KeyJ" }));

预期输出:

text
player.jump()
player.attack()

把 KeyboardAdapter 换成手柄或触屏适配器时,只要仍返回相同动作名,PlayerController 无需修改。这就是边界是否有效的最直接验证。

避免三种反向耦合

第一种是输入核心直接持有角色对象,例如检测到空格后调用 player.jump()。这会让输入模块依赖具体玩法对象,也让输入逻辑难以独立测试。

第二种是 UI 直接查询键盘状态。这样菜单确认、文本输入和游戏控制会分散在不同组件中,输入焦点与上下文切换很难统一处理。

第三种是设备适配器知道业务状态,例如“背包打开时忽略攻击键”。设备层不应该理解背包;更合适的做法是在动作路由或输入上下文层决定当前哪些动作可用。

用替换测试检查边界

完成设计后,可以做两个快速检查。把键盘适配器替换成一个模拟适配器,如果角色逻辑完全不用改,说明玩法层没有泄漏设备依赖;再把 PlayerController 替换成菜单消费者,如果输入核心也不用改,说明它没有绑定具体业务对象。

输入系统真正需要稳定的是“动作如何被表达和传递”,而不是某个设备 API。只要设备细节停在适配层、业务规则停在消费者侧,中间核心就能保持可替换、可测试和可扩展。

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

目录与阅读设置

阅读设置

17

记录一个想法

确定输入系统的边界和依赖方向

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

登录哪都通