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

区分默认配置与玩家配置

区分默认配置与玩家配置

输入映射一旦允许玩家改键,就不能再用“一份配置直接覆盖所有内容”的做法。本节建立系统默认、平台默认和玩家自定义三层配置,并明确加载顺序、覆盖粒度与恢复默认时应该删除什么。

学习目标

  • 理解系统默认、平台默认和玩家配置各自负责什么。
  • 设计稳定的加载与覆盖顺序,避免玩家配置被升级后的默认值误覆盖。
  • 用可运行示例验证按 Binding 标识合并后的最终结果。

三层配置解决三个不同问题

系统默认配置提供所有平台都成立的基础绑定,例如 jump -> keyboard:Space。平台默认配置只描述某个平台的差异,例如主机使用手柄、掌机增加特定按键。玩家配置只保存玩家实际修改过的条目,而不是复制整份默认配置。

这样做有两个直接好处:游戏升级新增 Action 时,玩家仍能自动拿到新的默认绑定;玩家没有修改过的旧 Binding,也能继续跟随平台默认配置变化。

输入配置的加载与覆盖关系

合并单位应当是稳定的 Binding 标识

最安全的覆盖单位不是数组位置,而是稳定的 bindingId。如果默认配置以后调整排序,按数组下标覆盖会把玩家修改应用到错误条目。

下面示例按照 bindingId 依次合并系统默认、平台默认与玩家覆盖。后出现的同名 Binding 覆盖前面的字段,没有出现的字段继续继承。

ts
type BindingConfig = {
  bindingId: string;
  actionId: string;
  device: "keyboard" | "gamepad";
  control: string;
  disabled?: boolean;
};

function mergeLayers(...layers: BindingConfig[][]): BindingConfig[] {
  const merged = new Map<string, BindingConfig>();

  for (const layer of layers) {
    for (const item of layer) {
      const previous = merged.get(item.bindingId);
      merged.set(item.bindingId, previous ? { ...previous, ...item } : item);
    }
  }

  return [...merged.values()].filter((item) => !item.disabled);
}

const systemDefaults: BindingConfig[] = [
  { bindingId: "jump-primary", actionId: "jump", device: "keyboard", control: "Space" },
  { bindingId: "pause-primary", actionId: "pause", device: "keyboard", control: "Escape" }
];

const platformDefaults: BindingConfig[] = [
  { bindingId: "jump-primary", actionId: "jump", device: "gamepad", control: "ButtonSouth" }
];

const playerOverrides: BindingConfig[] = [
  { bindingId: "jump-primary", actionId: "jump", device: "gamepad", control: "ButtonEast" }
];

console.log(mergeLayers(systemDefaults, platformDefaults, playerOverrides));

预期输出:

text
[
  {
    bindingId: 'jump-primary',
    actionId: 'jump',
    device: 'gamepad',
    control: 'ButtonEast'
  },
  {
    bindingId: 'pause-primary',
    actionId: 'pause',
    device: 'keyboard',
    control: 'Escape'
  }
]

打印格式可能因运行环境不同略有差异,但最终 jump-primary 应来自玩家配置,而 pause-primary 仍保留系统默认值。

玩家配置只记录差异

玩家把跳跃从 ButtonSouth 改成 ButtonEast 时,只需要保存这一个覆盖项。不要把当前所有有效绑定整体写入玩家文件,否则默认配置新增动作后,旧玩家文件会像一张过期快照一样阻止新默认值生效。

如果需要“解绑”,也不要直接删除默认项,因为下一次加载默认层时它会重新出现。更稳妥的做法是写入同一 bindingId 并标记 disabled: true,让最高优先级明确表达“玩家主动禁用此绑定”。

恢复默认就是移除最高优先级覆盖

“恢复默认”不应该把默认值复制进玩家配置,而应该删除对应玩家覆盖,让下层配置重新生效。恢复单个按键时删除该 bindingId 的覆盖;恢复全部时清空玩家覆盖集合。

平台切换时也遵循同一规则:先加载新的平台默认层,再应用同一份玩家差异。若某条玩家绑定引用了新平台不存在的设备或控件,应在加载校验阶段标记为无效,而不是静默改成另一个按键。

只要把加载顺序固定为“系统默认 → 平台默认 → 玩家覆盖”,并以稳定 Binding 标识进行细粒度覆盖,默认升级、跨平台适配和玩家改键就能同时保持可预测。

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

目录与阅读设置

阅读设置

17

记录一个想法

区分默认配置与玩家配置

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

登录哪都通