游戏客户端架构 / 系统课时
让上层逻辑摆脱设备类型
让上层逻辑摆脱设备类型
角色移动、跳跃和交互不应该知道输入来自键盘、手柄还是触屏。本节把设备事件先转换成统一动作状态,再让玩法层只依赖动作接口,从而隔离平台 API、减少条件分支,并为换键、跨平台和自动测试留下稳定边界。
学习目标
- 理解设备输入、输入适配层与玩法命令之间的职责边界
- 用统一动作接口避免在角色代码中判断键鼠、手柄或触屏
- 能判断哪些逻辑应留在适配层,哪些逻辑应进入玩法层
把设备差异挡在玩法代码之外
最直接但最难维护的写法,是在角色更新逻辑里同时读取键盘、手柄和触屏:键盘检查按键,手柄检查摇杆和按钮,触屏再检查虚拟摇杆。设备一多,角色代码会不断出现“如果当前是某设备”的分支。
更稳定的边界是:设备层只负责采集原始输入,适配层把不同设备翻译成统一动作,玩法层只消费动作。例如键盘 W、手柄左摇杆向上、触屏虚拟摇杆向上,都可以变成 MoveY = 1;Space、手柄 A 键和触屏跳跃按钮,都可以变成 Jump = true。

这层关系的关键不是“多包一层”,而是让依赖方向固定:玩法层依赖稳定的动作模型,而不是依赖易变化的设备 API。新增设备时,主要修改适配层;角色移动、战斗和交互逻辑通常无需改动。
用统一动作快照组织输入
下面用一个可运行的 TypeScript 示例模拟两种设备适配器。示例不依赖具体游戏引擎,重点展示上层只认识 ActionState。
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()));预期输出:
moving=true, jump=falseupdateCharacter 没有出现 KeyboardAdapter、GamepadAdapter 或任何设备判断。实际项目中,可以在启动或设备切换时选择适配器,也可以把多个适配器的结果合并后再生成当前帧的动作快照。
适配层应该做什么
适配层适合处理“输入表达差异”,例如按键与按钮映射、摇杆死区、轴值归一化、触屏坐标转换,以及“按下、持续、释放”这类基础状态整理。它的输出应尽量稳定、与平台无关。
玩法层则负责“动作意味着什么”。Jump = true 是否真的能起跳,要由角色状态决定;角色正在眩晕、游泳或攀爬时如何响应,也属于玩法规则。不要把这些规则塞回输入适配层,否则输入模块会逐渐知道太多角色状态。
什么时候需要更进一步
如果项目只有单平台、单设备且原型生命周期很短,直接读取设备 API 也能工作。但一旦需要重绑定、多设备共存、手柄热插拔、移动端触控、回放或自动化测试,统一动作层会明显降低改动范围。
判断设计是否成功,可以做一个简单检查:把键盘适配器替换成手柄适配器后,如果角色和玩法代码完全不用改,只替换输入来源或绑定配置,那么上层逻辑就真正摆脱了设备类型。