游戏客户端架构 / 系统课时
Steam 云存档和本地存档怎么衔接
Steam 云存档和本地存档怎么衔接
这节解决一个最容易设计反的问题:Steam Cloud 不应该取代本地存档,而应该围绕本地存档做同步。最终目标是让游戏在离线时照常保存,在联网时可靠同步,并在多设备同时修改后保留可恢复的冲突现场。
学习目标
- 区分本地存档、Steam 云同步和冲突决策各自的职责
- 设计可判断“只改本地、只改云端、两边都改”的同步元数据
- 建立不会因盲目覆盖而丢档的同步流程
先确定谁是存档系统的事实来源
游戏运行时应只依赖本地存档层完成保存和读取。Steam Cloud 的职责是把已经提交成功的本地数据复制到其他设备,或者把远端候选版本带回本机,而不是让每次游戏逻辑都直接访问云端。
这样做有两个直接收益:Steam 离线、网络抖动或客户端尚未完成同步时,游戏仍然可以读写;测试环境也能在不启动 Steam 的情况下验证存档逻辑。无论采用 Steam Auto-Cloud 同步指定目录,还是通过 Remote Storage API 自己管理文件,都应保持同一条边界:先完成本地事务,再处理云同步。

用同步元数据判断版本关系
不要只比较文件修改时间。两台设备的系统时钟可能不一致,离线期间也可能各自推进进度。更稳妥的做法是为每个存档槽维护一份自定义清单,记录版本、修订号、设备来源和内容哈希。
{
"saveId": "slot-01",
"schemaVersion": 3,
"revision": 128,
"updatedAtUtc": "2026-10-08T02:15:30Z",
"deviceId": "pc-a",
"contentHash": "sha256:<HASH>",
"baseCloudRevision": 127
}这些字段是游戏自己的同步元数据,不是 Steam API 规定的固定字段。revision 表示本地成功提交后的逻辑版本,baseCloudRevision 表示本机最后一次确认同步过的云端修订号,contentHash 用于识别“时间不同但内容相同”的情况。
判断时关注“自上次共同基线以后谁发生了变化”:
| 本地变化 | 云端变化 | 建议动作 |
|---|---|---|
| 否 | 否 | 不处理 |
| 是 | 否 | 上传本地版本 |
| 否 | 是 | 下载云端版本 |
| 是 | 是 | 进入冲突处理,先保留两份 |
把冲突当成正常状态处理
多设备离线游玩时,双方都可能从同一个基线继续推进。例如 PC A 把角色升到 20 级,Steam Deck 又在旧存档上完成了另一条任务。此时单纯按时间“较新者覆盖较旧者”会永久丢掉另一条进度。
对于难以自动合并的游戏存档,最稳妥的默认策略是保留两个物理文件,并生成一个冲突记录。用户选择某个版本后,再把它写回正式槽位并产生新的 revision。如果游戏数据天然可合并,例如不同关卡的独立解锁集合,则可以在领域层做合并,但不要把合并规则写进 Steam 适配器。
处理上传、下载和退出时机
保存操作完成后,先确保临时文件写完、校验通过并原子替换正式文件,再把该修订标记为“可同步”。如果由 Steam 客户端管理 Auto-Cloud,本地目录就是双方的交界面;如果使用 Remote Storage API,则由适配层把已提交的字节上传。
启动时也不要先覆盖本地文件。应先读取本地清单和远端候选信息,完成版本判断后再决定下载、上传或进入冲突状态。退出游戏时可以触发最后一次同步请求,但不要把“必须等云端成功”作为正常退出的前提,因为用户可能断网或强制关闭进程。
验证方案是否真的安全
至少覆盖三类测试:单设备连续保存、多设备轮流保存、两台设备离线后同时修改。测试时故意中断上传、让远端版本落后,并模拟本地文件已成功提交但云同步失败的情况。
验收标准不是“云端永远只有一份最新文件”,而是任何一次失败都不会破坏本地可读版本;任何一次双边修改都能识别冲突;用户做出选择前,两份数据都仍然可恢复。做到这三点,本地存档与 Steam Cloud 才算真正衔接起来。