> ## 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.

# Game Saves 開發人員指南

> 將 XBOX GDK Game Saves 整合到遊戲中，並提供術語、XGameSave 與 XGameSaveFiles API、使用者模型、PLM、安全性與認證的相關指引。

本指南提供將 Game Saves 功能整合到遊戲中的起點。內容涵蓋重要術語的概觀、可用 API 的大綱，以及使用者模型、安全性和認證需求等重要考量。

## 概觀

下列術語會出現在整個 Game Saves 生態系統中。

* **Game Saves 生態系統**：先前稱為 *Connected Storage* 或 `XGameSave`，此生態系統管理遊戲如何在裝置上儲存資料，並將該資料與雲端同步。此生態系統會將儲存的資料組織成容器和 Blob。此組織方式有助於遊戲跨裝置儲存、更新和擷取玩家進度。
* **遊戲 (Title)**：您正在開發的遊戲。
* **沙箱**：您的遊戲執行所在的環境。
* **Microsoft Partner Center**：管理遊戲設定和沙箱的 Microsoft 入口網站。
* **服務設定識別碼 (SCID)：** XBOX services 中遊戲服務設定的唯一識別碼。
* **Microsoft 帳戶 (MSA) App ID (MSAAppID)**：將遊戲連結至其 Microsoft 帳戶身分識別的必要識別碼。此值會在 Partner Center 中產生，並放在 MicrosoftGame.config 中，讓 XBOX services (包括登入、成就、雲端存檔和使用者資料) 能夠正確驗證遊戲。

下列常見的服務術語會出現在 Game Saves API 中。

* **本機儲存空間**：在遊戲過程中儲存到裝置的資料。
* **Title storage/雲端：** 當裝置連線到網際網路時，儲存空間會自動與雲端上的 Title storage 同步。
* **鎖定：** 一種機制，針對使用者正在使用的裝置，授與特定使用者對遊戲 Game Saves 的獨佔存取權。鎖定可確保在持有鎖定期間，沒有其他裝置可以修改該使用者的 Game Saves。
  * 例如，如果使用者在裝置 A 上遊玩遊戲 T，該裝置就會為該使用者持有遊戲 T 的鎖定。
* **提供者：** 與 Game Save 系統通訊的中介機制，負責管理遊戲資料。提供者也會管理裝置上使用者的鎖定。
* **容器**：類似於資料夾。
* **Blob**：類似於個別檔案。

## 新遊戲

使用 Game Saves 之前，您的遊戲必須在 Partner Center 中啟用 XBOX services。此服務會為您的遊戲提供 SCID 和 MSAAppID。如需詳細資訊，請參閱[為您的遊戲啟用 XBOX services 和 Game Saves](/zh-TW/build/core-features/common/game-save/game-saves-walkthroughs-and-samples#enabling-xbox-services-and-game-saves-for-your-title)。

設定 Partner Center 之後，建議使用 [XGameSaveFiles](/zh-TW/build/core-features/common/game-save/xgamesavefiles) 來實作 Game Saves。

## Game Saves API

| API | 描述 | 平台 | 使用案例 | 範例 |
| - | - | - | - | - |
| [XGameSaveFiles](/zh-TW/build/core-features/common/game-save/xgamesavefiles) | 提供 Game Saves 本機儲存空間的檔案路徑，會自動同步至雲端。 | PC、XBOX | 建議在大多數案例中使用此 API。提供可供您讀取/寫入並自動同步至雲端的檔案路徑。 | [GameSaveFilesCombo](https://learn.microsoft.com/samples/microsoft/xbox-gdk-samples/gamesavefilescombo/) |
| [無程式碼雲端存檔](/zh-TW/build/core-features/common/game-save/game-saves-walkthroughs-and-samples#porting-previous-titles-to-pc-game-saves-with-no-code-cloud-saves) | 您提供會自動同步至雲端的檔案路徑。 | PC | 非常適合無法直接使用 GDK 或要移植到 PC Game Pass 的 PC 遊戲。在遊戲 .config 檔案中提供讀取/寫入路徑。 | 無 |
| [XGameSave](/zh-TW/build/core-features/common/game-save/xgamesave) | 資料會儲存在本機並同步至雲端。 | PC、XBOX | 支援需要更大或更複雜之每位使用者儲存空間的遊戲。提供詳細的檔案管理控制。 | [GameSaveCombo](https://learn.microsoft.com/samples/microsoft/xbox-gdk-samples/gamesavecombo/) |

## 使用者模型

遊戲支援兩種類型的使用者模型。建議使用簡單使用者模型。

| 方法 | 描述 | 範例連結 | 零售平台差異 |
| - | - | - | - |
| 簡單使用者模型 | 需要預設使用者。預設使用者控制遊戲執行個體的存留期。OS 會確保使用者在遊戲啟動時登入。 | [SimpleUserModel](https://learn.microsoft.com/samples/microsoft/xbox-gdk-samples/simpleusermodel/) | PC：預設使用者登出時，遊戲會終止。<br /><br /> 主機：預設使用者登出時，遊戲會暫停。 |
| 進階使用者模型 | 沒有預設使用者。無法保證遊戲啟動時有使用者登入。 | 無 | 無 |

如需使用者模型的詳細資訊，請參閱 [GDK 使用者模型](/zh-TW/build/core-features/common/user/gamecore-user-models)。

如需登入使用者的最佳做法相關資訊，請參閱[操作說明：登入使用者的最佳做法](/zh-TW/build/core-features/common/user/xuser_howto_best_practice_signing_in)。

## 安全性

### 個人資料

Microsoft 不提供可讓您存取特定使用者 Game Saves 資料的 API 或工具。如果您需要此資訊來疑難排解問題，請直接連絡使用者，並請他們分享。

### 安全地儲存

啟用 PC 存取性時，Game Saves 並不安全。透過 PC 存取性，使用者可以直接開啟檔案路徑，進而公開儲存的資料。建議您使用自己的伺服器端檢查來確認存檔的適當狀態。

## 認證需求

### XR-052

[XR-052 使用者狀態與遊戲存檔位置、漫遊和相依性](https://learn.microsoft.com/build/store/policies/XR/XR052)


## Related topics

- [認證主機 BVT 指南](/zh-TW/publishing/game-publishing/concepts/certification/certification-console-bvt-guide.md)
- [認證 PC BVT 指南](/zh-TW/publishing/game-publishing/concepts/certification/certification-pc-bvt-guide.md)
- [認證逐步指南](/zh-TW/publishing/game-publishing/concepts/certification/certification-guide.md)
- [XBOX 主機遊戲的認證測試 XBOX 需求](/zh-TW/publishing/certification/console-cert-tested-requirements.md)
- [XR-018：使用者產生的內容](/zh-TW/publishing/certification/xr/xr-018.md)