> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # 游戏存档概述 > 了解 XBOX 游戏存档如何在 XBOX 主机、PC 和掌上设备之间同步玩家进度，并按照从设置到发布的开发生命周期进行操作。 ## 简介 游戏存档使用户能够在设备之间无缝切换，只要他们登录，就能获取到自己的进度。系统会在本地保存数据，然后在设备连接到互联网时将其同步到云端。同步完成后，用户可以在任何受支持的设备上访问其保存的数据。 ## XBOX Play Anywhere 和游戏存档 XBOX Play Anywhere 使用游戏存档使用户能够跨 Windows 设备、XBOX 主机、PC 和掌上设备无缝共享游戏进程。XBOX Play Anywhere 依赖于一致的存档数据同步。用户可以在任何受支持的设备上继续之前的进度。有关更多信息，请参阅 [XBOX Play Anywhere](https://www.xbox.com/games/xbox-play-anywhere)。 ## 游戏存档开发生命周期 游戏存档开发生命周期一文为你提供了一条结构化路径，用于构建、验证和维护可靠的云连接存档系统。它将引导你了解如何将游戏存档引入新标题，并延续到调试、测试、认证和发布后支持。每个阶段都突出显示了你需要的要求、工具和最佳实践，以确保你的标题一致地保存数据、安全地同步数据，并在设备间提供无缝的用户体验。 此生命周期有助于确保你的游戏存档实现从首次原型到发布及以后的行为可预测。 生命周期一文描述了你规划、实施、验证、发布和维护游戏存档时的端到端流程。此生命周期描述如下。 1. **开始使用游戏存档：** 通过游戏存档概念、API、存储模型和平台要求进行初始入门。 2. **新标题设置：** 在开发早期集成游戏存档。例如： * 添加依赖于用户登录的初始化。 * 配置服务配置标识符 (SCID) 和 Microsoft 帐户 (MSA) 应用 ID (MSAAppID) 等标识符。 * 建立你的存储设计和容器结构。 3. **开发期间调试问题：** 排查早期实施问题。你可能会遇到以下问题： * SCID 配置问题 * 句柄生命周期问题 * 配额/内存问题 * NTSTATUS 错误解释 4. **测试计划：** 定义结构化测试计划。例如，测试以下领域： * 数据读/写正确性 * 离线行为 * 同步逻辑 * 系统对话框流程 * 多设备场景 5. **测试场景：** 执行详细的功能和压力测试。例如，测试标题在以下情况下的行为。 * 连接性变化 * 冲突状态 * 用户切换 * 损坏处理 * 存储限制边缘情况 6. **准备发布你的标题：** 在发布之前完成你的游戏存档配置。此工作通常包括以下任务： * 验证你的 Microsoft 合作伙伴中心设置 * 确认你的标题使用正确的配额 * 确保系统对话框按预期工作 * 验证你的标题使用安全写入模式 7. **认证要求：** 满足 XBOX 认证要求。例如： * 正确的同步行为。 * 管理连接性变化。 * 遵守用户数据和个人身份信息 (PII) 规则。 8. **发布后管理问题：** 监视和解决线上问题。你可能会遇到以下情况： * 同步失败。 * 用户数据丢失报告。 * 存储限制问题。 9. **迁移场景：** 场景包括以下项目： * 更新存储布局 * 在游戏存档 API 之间迁移 * 在标题版本之间过渡 ## 游戏存档文档集 本文档集帮助你理解和实现完整的游戏存档生态系统。此文档集介绍了 API 的工作原理、用户模型和进程生命周期管理 (PLM) 如何影响你的存档数据流程，以及存储系统、配额和离线行为如何影响你的设计。它还提供了测试和调试指南，介绍了用户可能遇到的系统对话框，并概述了发布前需要满足的认证要求。 ### 游戏存档开发者指南 本文提供了游戏存档生态系统和关键开发者注意事项的概述，例如可用 API、用户模型、PLM、安全性/PII 指南、认证要求和存储限制详细信息。 * [概述](/build/core-features/common/game-save/game-saves-developer-guide#overview) * [新标题](/build/core-features/common/game-save/game-saves-developer-guide#new-titles) * [游戏存档 API](/build/core-features/common/game-save/game-saves-developer-guide#game-saves-apis) * [用户模型](/build/core-features/common/game-save/game-saves-developer-guide#user-models) * [安全性](/build/core-features/common/game-save/game-saves-developer-guide#security) * [认证要求](/build/core-features/common/game-save/game-saves-developer-guide#certification-requirements) ### 理解游戏存档同步流程 本文介绍了容器/文件夹级别的原子性和六步同步流程，还有离线模式行为和仅机器的提供程序使用。 * [标题启动](/build/core-features/common/game-save/game-saves-syncing#title-start) * [连接检查](/build/core-features/common/game-save/game-saves-syncing#connection-check) * [数据所有权检查](/build/core-features/common/game-save/game-saves-syncing#data-ownership-check) * [与云同步数据](/build/core-features/common/game-save/game-saves-syncing#syncing-data-with-the-cloud) * [游戏循环](/build/core-features/common/game-save/game-saves-syncing#gameplay-loop) * [会话结束](/build/core-features/common/game-save/game-saves-syncing#session-end) * [连接丢失和锁场景](/build/core-features/common/game-save/game-saves-syncing#connection-loss-and-lock-scenarios) * [断电](/build/core-features/common/game-save/game-saves-syncing#power-loss) ### 游戏存档存储系统 本文概述了各种存储环境。它涵盖了标题存储（云）、本地存档存储和机器提供程序存储，以及每个标题的配额和特定主机的本地存储详细信息。 * [游戏存档存储系统](/build/core-features/common/game-save/game-saves-storage-systems) * [限制和配额](/build/core-features/common/game-save/game-saves-storage-systems#limits-and-quotas) * [特定主机的本地存储](/build/core-features/common/game-save/game-saves-storage-systems#console-specific-local-storage-system) ### 游戏存档系统对话框 本文介绍了用户执行游戏存档操作时可能遇到的系统对话框。 * [系统对话框一览](/build/core-features/common/game-save/game-saves-dialogues#system-dialogs-at-a-glance) * [游戏存档对话框](/build/core-features/common/game-save/game-saves-dialogues#game-saves-dialogs) ### 游戏存档演练和示例 本文介绍如何设置合作伙伴中心，以及如何使用安全写入模式（例如写入临时文件并原子替换）。它还介绍了如何管理离线和无网络场景以及如何使用系统对话框流程。此外，还介绍了如何在使用中的设备上管理游戏存档数据、测试云同步行为，以及在标题或 API 之间迁移。 * [合作伙伴中心配置](/build/core-features/common/game-save/game-saves-walkthroughs-and-samples#partner-center-configurations) * [开发场景](/build/core-features/common/game-save/game-saves-walkthroughs-and-samples#development-scenarios) * [测试场景](/build/core-features/common/game-save/game-saves-walkthroughs-and-samples#testing-scenarios) * [迁移场景](/build/core-features/common/game-save/game-saves-walkthroughs-and-samples#migration-scenarios) * [代码示例](/build/core-features/common/game-save/game-saves-walkthroughs-and-samples#code-samples) ### 游戏存档调试 本文介绍了常见的游戏存档错误和故障排除步骤，包括 SCID 问题、句柄生命周期最佳实践、配额和内存限制以及如何解释 Win32 `NTSTATUS` 代码。 * [常见错误场景](/build/core-features/common/game-save/game-saves-debugging#common-game-saves-error-scenarios) * [常见错误表](/build/core-features/common/game-save/game-saves-debugging#common-errors) ### 游戏存档工具 本文介绍如何使用 Fiddler 检查游戏存档网络流量。它还展示了如何使用 `xbstorage` 和 `gamesaveutil` 命令行工具在主机和 PC 上导出或导入本地存档数据。 * [检查游戏存档网络流量](/build/core-features/common/game-save/game-saves-tools#inspecting-game-saves-network-traffic) * [游戏存档工具](/build/core-features/common/game-save/game-saves-tools) ### XGameSaveFiles API 概述 本文介绍 `XGameSaveFilesGetFolderWithUIAsync` 的初始化流程、推荐的 Win32 自动云同步语义、配额/调试指南、性能最佳实践和常见问题解答。 * [实现](/build/core-features/common/game-save/xgamesavefiles#implementation-of-xgamesavefiles) * [游戏存档流程](/build/core-features/common/game-save/xgamesavefiles#game-saves-flow) * [限制和配额](/build/core-features/common/game-save/xgamesavefiles#limits-and-quotas) * [常见问题解答](/build/core-features/common/game-save/xgamesavefiles#faqs) ### XGameSave API 概述 本文介绍了容器和 blob 存储模型、如何初始化和关闭提供程序，以及更新句柄如何在其生命周期中移动。它还涵盖了原子更新行为、同步流程图、文件大小和配额限制、推荐的最佳实践和常见问题解答。 * [实现](/build/core-features/common/game-save/xgamesave#implementation) * [游戏存档流程](/build/core-features/common/game-save/xgamesave#game-saves-flow) * [限制和配额](/build/core-features/common/game-save/xgamesavefiles#limits-and-quotas) * [最佳实践](/build/core-features/common/game-save/xgamesave#best-practices) * [常见问题解答](/build/core-features/common/game-save/xgamesave#faqs) ## Related topics - [游戏存档概述](/zh-CN/services/playfab/player-progression/game-saves/overview.md) - [PlayFab 游戏存档 Steam Deck 实现指南](/zh-CN/services/playfab/player-progression/game-saves/steam-deck-implementation.md) - [游戏存档（目录）](/zh-CN/build/core-features/common/game-save/game-saves-toc.md) - [Connected Storage](/zh-CN/services/xbox-services/storage/connected-storage/live-connected-storage-nav.md) - [XGameSave Wrapper reference index and member list](/zh-CN/reference/system/Wrappers/xgamesave_wrapper_members.md)