游戏客户端架构 / 系统课时
区分默认配置与玩家配置
区分默认配置与玩家配置
输入映射一旦允许玩家改键,就不能再用“一份配置直接覆盖所有内容”的做法。本节建立系统默认、平台默认和玩家自定义三层配置,并明确加载顺序、覆盖粒度与恢复默认时应该删除什么。
学习目标
- 理解系统默认、平台默认和玩家配置各自负责什么。
- 设计稳定的加载与覆盖顺序,避免玩家配置被升级后的默认值误覆盖。
- 用可运行示例验证按 Binding 标识合并后的最终结果。
三层配置解决三个不同问题
系统默认配置提供所有平台都成立的基础绑定,例如 jump -> keyboard:Space。平台默认配置只描述某个平台的差异,例如主机使用手柄、掌机增加特定按键。玩家配置只保存玩家实际修改过的条目,而不是复制整份默认配置。
这样做有两个直接好处:游戏升级新增 Action 时,玩家仍能自动拿到新的默认绑定;玩家没有修改过的旧 Binding,也能继续跟随平台默认配置变化。

合并单位应当是稳定的 Binding 标识
最安全的覆盖单位不是数组位置,而是稳定的 bindingId。如果默认配置以后调整排序,按数组下标覆盖会把玩家修改应用到错误条目。
下面示例按照 bindingId 依次合并系统默认、平台默认与玩家覆盖。后出现的同名 Binding 覆盖前面的字段,没有出现的字段继续继承。
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));预期输出:
[
{
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 标识进行细粒度覆盖,默认升级、跨平台适配和玩家改键就能同时保持可预测。