游戏客户端架构 / 系统课时
让输入配置支持运行时重载
让输入配置支持运行时重载
运行时重载的目标不是“重新读一次文件”,而是在游戏不中断的情况下完成加载、校验、替换和持久化,同时保证失败时仍继续使用旧配置。本节把这条生命周期拆成可验证的步骤,并用原子替换避免半更新状态。
学习目标
- 建立输入配置从加载到重新应用的完整生命周期
- 理解为什么校验失败时不能直接覆盖当前运行配置
- 实现一次可回滚的运行时重载并验证结果
把重载看成一次配置事务
安全的重载顺序应当是:读取候选配置、解析、校验、构建新映射、一次性替换当前映射。只有替换成功后,新的输入方案才进入运行状态;如果任一步失败,旧映射继续工作。
保存则是另一条路径:用户修改内存中的候选配置,校验通过后先应用,再持久化到磁盘。这样即使磁盘写入失败,也能明确区分“运行时已生效”和“持久化失败”,而不是把两种状态混在一起。

用不可变快照完成原子替换
下面的示例用一个新的 Map 构建候选映射。只有全部校验通过后,才把 activeBindings 指向新快照,因此读取输入的代码永远只会看到“旧版本”或“新版本”,不会看到替换一半的中间状态。
type InputConfig = Record<string, string>;
class InputRuntime {
private activeBindings = new Map<string, string>();
reload(config: InputConfig): void {
const next = new Map<string, string>();
for (const [action, source] of Object.entries(config)) {
if (!action.trim()) {
throw new Error("Action name cannot be empty");
}
if (!source.trim()) {
throw new Error(`Input source is empty for ${action}`);
}
if (next.has(action)) {
throw new Error(`Duplicate action: ${action}`);
}
next.set(action, source);
}
// 所有校验完成后再一次性替换,避免运行时读到半更新状态。
this.activeBindings = next;
}
sourceOf(action: string): string | undefined {
return this.activeBindings.get(action);
}
}
const runtime = new InputRuntime();
runtime.reload({
Jump: "Keyboard:Space",
Interact: "Keyboard:E"
});
console.log(runtime.sourceOf("Jump"));
try {
runtime.reload({
Jump: "",
Interact: "Keyboard:F"
});
} catch (error) {
console.log((error as Error).message);
}
console.log(runtime.sourceOf("Jump"));预期输出:
Keyboard:Space
Input source is empty for Jump
Keyboard:Space第二次重载失败后,Jump 仍然保持旧绑定,说明候选配置没有污染当前运行状态。
修改、保存和重新应用要分开
运行时编辑时,建议维护三类状态:当前生效快照、正在编辑的候选配置、最后一次成功持久化的配置版本。用户按下“应用”时,只做校验和替换;按下“保存”时,再把已经通过校验的候选配置写入持久化存储。
这种拆分能处理两个常见场景。第一,玩家想临时试用新键位但还不想保存;第二,磁盘写入或云同步失败时,仍能准确提示“本次会话已生效,但未保存”,而不是假装全部成功。
什么时候触发重载
常见触发点包括玩家在设置界面点击“应用”、外部配置文件被热更新、账号配置从云端同步完成,以及开发阶段的调试热加载。无论来源是什么,都应进入同一条重载管线,不要让不同入口各自实现一套解析和校验逻辑。
验收时至少检查三件事:有效配置无需重启即可生效;无效配置不会破坏当前绑定;保存失败与应用失败能被分别识别。满足这三点后,运行时重载才真正具备可用性,而不仅仅是“重新读文件”。