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

让上层逻辑摆脱设备类型

让上层逻辑摆脱设备类型

角色移动、跳跃和交互不应该知道输入来自键盘、手柄还是触屏。本节把设备事件先转换成统一动作状态,再让玩法层只依赖动作接口,从而隔离平台 API、减少条件分支,并为换键、跨平台和自动测试留下稳定边界。

学习目标

  • 理解设备输入、输入适配层与玩法命令之间的职责边界
  • 用统一动作接口避免在角色代码中判断键鼠、手柄或触屏
  • 能判断哪些逻辑应留在适配层,哪些逻辑应进入玩法层

把设备差异挡在玩法代码之外

最直接但最难维护的写法,是在角色更新逻辑里同时读取键盘、手柄和触屏:键盘检查按键,手柄检查摇杆和按钮,触屏再检查虚拟摇杆。设备一多,角色代码会不断出现“如果当前是某设备”的分支。

更稳定的边界是:设备层只负责采集原始输入,适配层把不同设备翻译成统一动作,玩法层只消费动作。例如键盘 W、手柄左摇杆向上、触屏虚拟摇杆向上,都可以变成 MoveY = 1;Space、手柄 A 键和触屏跳跃按钮,都可以变成 Jump = true。

设备输入经过适配层转换为统一动作后再进入玩法逻辑

这层关系的关键不是“多包一层”,而是让依赖方向固定:玩法层依赖稳定的动作模型,而不是依赖易变化的设备 API。新增设备时,主要修改适配层;角色移动、战斗和交互逻辑通常无需改动。

用统一动作快照组织输入

下面用一个可运行的 TypeScript 示例模拟两种设备适配器。示例不依赖具体游戏引擎,重点展示上层只认识 ActionState。

ts
type ActionState = {
  moveX: number;
  moveY: number;
  jump: boolean;
};

interface InputAdapter {
  read(): ActionState;
}

class KeyboardAdapter implements InputAdapter {
  read(): ActionState {
    // 这里模拟 W + D + Space 被平台层采集后的结果。
    return { moveX: 1, moveY: 1, jump: true };
  }
}

class GamepadAdapter implements InputAdapter {
  read(): ActionState {
    // 摇杆和按钮先被归一化成与键盘一致的动作表达。
    return { moveX: 0.8, moveY: 0.6, jump: false };
  }
}

function updateCharacter(input: ActionState): string {
  const moving = Math.abs(input.moveX) > 0 || Math.abs(input.moveY) > 0;
  return `moving=${moving}, jump=${input.jump}`;
}

const adapter: InputAdapter = new GamepadAdapter();
console.log(updateCharacter(adapter.read()));

预期输出:

text
moving=true, jump=false

updateCharacter 没有出现 KeyboardAdapter、GamepadAdapter 或任何设备判断。实际项目中,可以在启动或设备切换时选择适配器,也可以把多个适配器的结果合并后再生成当前帧的动作快照。

适配层应该做什么

适配层适合处理“输入表达差异”,例如按键与按钮映射、摇杆死区、轴值归一化、触屏坐标转换,以及“按下、持续、释放”这类基础状态整理。它的输出应尽量稳定、与平台无关。

玩法层则负责“动作意味着什么”。Jump = true 是否真的能起跳,要由角色状态决定;角色正在眩晕、游泳或攀爬时如何响应,也属于玩法规则。不要把这些规则塞回输入适配层,否则输入模块会逐渐知道太多角色状态。

什么时候需要更进一步

如果项目只有单平台、单设备且原型生命周期很短,直接读取设备 API 也能工作。但一旦需要重绑定、多设备共存、手柄热插拔、移动端触控、回放或自动化测试,统一动作层会明显降低改动范围。

判断设计是否成功,可以做一个简单检查:把键盘适配器替换成手柄适配器后,如果角色和玩法代码完全不用改,只替换输入来源或绑定配置,那么上层逻辑就真正摆脱了设备类型。

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

目录与阅读设置

阅读设置

17

记录一个想法

让上层逻辑摆脱设备类型

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

登录哪都通