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

先定义一份跨引擎存档模型

先定义一份跨引擎存档模型

如果存档模型直接引用 Unity 组件、Unreal UObject 或 Godot 节点,存档格式就会被某个引擎的运行时结构绑死。更稳妥的做法是先定义一份只表达游戏事实的数据模型,再让不同引擎负责把运行时对象映射进去,从一开始就把“数据协议”和“引擎实现”分开。

学习目标

  • 定义与具体引擎类型无关的存档边界
  • 设计稳定的存档根对象、模块数据和版本字段
  • 建立保存、加载与迁移接口,避免业务系统直接依赖文件格式

先把运行时对象挡在存档边界之外

跨引擎模型只保存能够跨进程、跨版本表达的值,例如字符串、数字、布尔值、数组、键值对象和稳定 ID。不要把 GameObject、Actor、Node、组件引用、指针或场景实例直接放进存档。

可以把完整存档看成三层:最外层是文件级元数据,中间是各业务模块的持久化数据,最内层是实体和数值。引擎只负责把运行时对象转换成这些纯数据,并在加载后重新绑定资源和实例。

跨引擎存档模型的分层与映射关系

根对象只放长期稳定的信息

推荐让根对象承担“识别、版本、校验、分区”四类职责,而不是把所有业务字段平铺进去。下面用 TypeScript 表达接口约束;这是片段示例,用于描述跨引擎数据协议,不依赖具体引擎运行。

ts
type SaveId = string;

interface SaveEnvelope {
  saveVersion: number;
  saveId: SaveId;
  createdAtUtc: string;
  gameBuild: string;
  player: PlayerSave;
  world: WorldSave;
  quests: QuestSave[];
}

interface PlayerSave {
  playerId: string;
  level: number;
  hp: number;
  inventoryItemIds: string[];
}

interface WorldSave {
  sceneId: string;
  openedChestIds: string[];
  defeatedEnemyIds: string[];
}

interface QuestSave {
  questId: string;
  state: "locked" | "active" | "completed";
}

这组接口刻意没有出现引擎对象。sceneId、questId、playerId 等都应该是项目自己维护的稳定标识,而不是实例地址、节点路径或运行时自动生成的短期 ID。这样换引擎、换场景组织方式时,存档协议仍然可以保持不变。

让业务系统通过适配接口接入

存档服务不应该直接遍历整个场景树,也不应该知道每个系统内部如何组织对象。更稳妥的是由各业务模块主动实现“导出纯数据”和“根据纯数据恢复”两个方向的适配。

下面仍是片段示例,重点是接口边界:

ts
interface SaveAdapter<T> {
  capture(): T;
  restore(data: T): void;
}

interface SaveRepository {
  write(slot: string, save: SaveEnvelope): Promise<void>;
  read(slot: string): Promise<SaveEnvelope>;
}

其中 SaveAdapter<T> 属于业务层与存档层之间的映射接口,SaveRepository 负责文件、云端或平台存储等介质差异。Unity 可以用 C# 实现同样语义,Unreal 可以用 C++/Blueprint 包装,Godot 可以用 GDScript 实现,但它们都应输出等价的数据字段。

版本迁移属于协议的一部分

跨引擎不等于“永远不改结构”。真正稳定的是迁移规则,而不是字段一成不变。每次出现破坏性变化时提升 saveVersion,加载旧档后按版本逐级迁移,再交给当前业务系统恢复。

例如旧版本只有 hp,新版本增加 maxHp,迁移时可以为旧档填入合理默认值。若某个字段只是运行时缓存,就不要为了兼容而把它加入协议;越少保存可重建数据,长期维护成本越低。

用一次序列化验证模型独立性

验证跨引擎模型最简单的方法,是把一份 SaveEnvelope 序列化成标准 JSON,然后确认其中只有稳定值,没有引擎类型名、内存地址、节点引用或资源实例。

json
{
  "saveVersion": 1,
  "saveId": "slot-001",
  "createdAtUtc": "2026-10-08T00:00:00Z",
  "gameBuild": "1.0.0",
  "player": {
    "playerId": "player-main",
    "level": 12,
    "hp": 86,
    "inventoryItemIds": ["item-potion-small", "item-key-forest"]
  },
  "world": {
    "sceneId": "forest-01",
    "openedChestIds": ["chest-forest-003"],
    "defeatedEnemyIds": ["enemy-wolf-007"]
  },
  "quests": [
    {
      "questId": "quest-find-key",
      "state": "completed"
    }
  ]
}

这段 JSON 是数据结构示例,不要求直接执行。验证时只需检查字段能否被任意标准 JSON 库读取,并确认所有对象引用都已转换为稳定 ID。只要这层协议保持纯数据,不同引擎之间的差异就会被限制在适配器内部,而不会扩散到存档格式本身。

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

目录与阅读设置

阅读设置

17

记录一个想法

先定义一份跨引擎存档模型

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

登录哪都通