> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 游戏存档（目录）

> 涵盖开发者指南、调试、工具、演练、同步流程、系统对话框和存储系统的 XBOX GDK 游戏存档文章索引。

本节提供了将可在不同设备之间漫游的标题数据保存到云端的概述、最佳实践和工具。

## 本节内容

[游戏存档概述](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/game-saves-overview.md)：游戏存档系统和目标的概述。包括游戏存档所有主要文章的附录。

[游戏存档开发者指南](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/game-saves-developer-guide.md)：游戏存档生态系统和关键开发者注意事项的概述，例如可用 API、用户模型、进程生命周期管理 (PLM)、安全性和个人身份信息 (PII) 指南、认证要求和存储限制详细信息。

[游戏存档调试](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/game-saves-debugging.md)：游戏存档常见错误场景和故障排除技术指南。包括服务配置标识符 (SCID) 问题、句柄生命周期最佳实践、配额和内存限制以及如何解释 Win32 NTSTATUS 代码。

[游戏存档工具](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/game-saves-tools.md)：介绍如何使用 Fiddler 检查游戏存档网络流量，以及如何使用 `xbstorage` 和 `gamesaveutil` 命令行工具在主机和 PC 上导出和导入本地存档数据。

[游戏存档演练和示例](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/game-saves-walkthroughs-and-samples.md)：提供 Microsoft Partner Center 设置、安全写入模式、离线行为、系统对话框流程、基于设备的存档数据管理、测试同步场景以及在标题/API 之间迁移的分步指南。

[理解游戏存档同步流程](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/game-saves-syncing.md)：介绍容器/文件夹级别的原子性和六步同步流程（标题启动、连接性、数据所有权、数据同步、游戏循环和会话结束），以及离线模式行为和仅机器提供程序的使用。

[游戏存档对话框](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/game-saves-dialogues.md)：包含用户执行游戏存档操作时可能获得的系统对话框的图像和描述。

[游戏存档存储系统](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/game-saves-storage-systems.md)：概述了各种存储环境：Title Storage（云）、本地存档存储和机器提供程序存储，以及每个标题的配额和特定主机的本地存储详细信息。

[XGameSaveFiles](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/xgamesavefiles.md)：涵盖 `XGameSaveFilesGetFolderWithUIAsync` 的初始化流程、推荐的 Win32 自动云同步语义、调试、配额/调试指南、性能最佳实践和常见问题解答。

[XGameSave](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/xgamesave.md)：介绍容器和 blob 模型，涵盖提供程序初始化、提供程序关闭和更新句柄生命周期。它还概述了原子更新行为、同步流程图、文件大小和配额约束，以及最佳实践和常见问题解答。


## Related topics

- [游戏存档](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/index.md)
- [所有平台通用的 GDK 功能](https://docs.xbox.com/zh-CN/build/core-features/common/common-features-overview.md)
- [游戏存档调试](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/game-saves-debugging.md)
- [游戏存档工具](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/game-saves-tools.md)
- [游戏存档存储系统](https://docs.xbox.com/zh-CN/build/core-features/common/game-save/game-saves-storage-systems.md)