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

让输入配置支持运行时重载

让输入配置支持运行时重载

运行时重载的目标不是“重新读一次文件”,而是在游戏不中断的情况下完成加载、校验、替换和持久化,同时保证失败时仍继续使用旧配置。本节把这条生命周期拆成可验证的步骤,并用原子替换避免半更新状态。

学习目标

  • 建立输入配置从加载到重新应用的完整生命周期
  • 理解为什么校验失败时不能直接覆盖当前运行配置
  • 实现一次可回滚的运行时重载并验证结果

把重载看成一次配置事务

安全的重载顺序应当是:读取候选配置、解析、校验、构建新映射、一次性替换当前映射。只有替换成功后,新的输入方案才进入运行状态;如果任一步失败,旧映射继续工作。

保存则是另一条路径:用户修改内存中的候选配置,校验通过后先应用,再持久化到磁盘。这样即使磁盘写入失败,也能明确区分“运行时已生效”和“持久化失败”,而不是把两种状态混在一起。

运行时输入配置重载生命周期

用不可变快照完成原子替换

下面的示例用一个新的 Map 构建候选映射。只有全部校验通过后,才把 activeBindings 指向新快照,因此读取输入的代码永远只会看到“旧版本”或“新版本”,不会看到替换一半的中间状态。

ts
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"));

预期输出:

text
Keyboard:Space
Input source is empty for Jump
Keyboard:Space

第二次重载失败后,Jump 仍然保持旧绑定,说明候选配置没有污染当前运行状态。

修改、保存和重新应用要分开

运行时编辑时,建议维护三类状态:当前生效快照、正在编辑的候选配置、最后一次成功持久化的配置版本。用户按下“应用”时,只做校验和替换;按下“保存”时,再把已经通过校验的候选配置写入持久化存储。

这种拆分能处理两个常见场景。第一,玩家想临时试用新键位但还不想保存;第二,磁盘写入或云同步失败时,仍能准确提示“本次会话已生效,但未保存”,而不是假装全部成功。

什么时候触发重载

常见触发点包括玩家在设置界面点击“应用”、外部配置文件被热更新、账号配置从云端同步完成,以及开发阶段的调试热加载。无论来源是什么,都应进入同一条重载管线,不要让不同入口各自实现一套解析和校验逻辑。

验收时至少检查三件事:有效配置无需重启即可生效;无效配置不会破坏当前绑定;保存失败与应用失败能被分别识别。满足这三点后,运行时重载才真正具备可用性,而不仅仅是“重新读文件”。

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

目录与阅读设置

阅读设置

17

记录一个想法

让输入配置支持运行时重载

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

登录哪都通