Skip to main content
本指南提供將 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。 設定 Partner Center 之後,建議使用 XGameSaveFiles 來實作 Game Saves。

Game Saves API

使用者模型

遊戲支援兩種類型的使用者模型。建議使用簡單使用者模型。 如需使用者模型的詳細資訊,請參閱 GDK 使用者模型。 如需登入使用者的最佳做法相關資訊,請參閱操作說明:登入使用者的最佳做法。

安全性

個人資料

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

安全地儲存

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

認證需求

XR-052

XR-052 使用者狀態與遊戲存檔位置、漫遊和相依性
Last modified on October 6, 2026