簡介
Game Saves 讓使用者每次登入時都能取得自己的進度，因此可以在不同裝置之間無縫切換。系統會先將資料儲存在本機，然後在裝置連線到網際網路時將其同步至雲端。同步完成後，使用者就可以在任何支援的裝置上存取其儲存的資料。XBOX Play Anywhere 與 Game Saves
XBOX Play Anywhere 使用 Game Saves，讓使用者能在 Windows 裝置、XBOX 主機、PC 和掌上型裝置之間無縫共用遊戲進度。XBOX Play Anywhere 依賴一致的存檔資料同步。使用者可以在任何支援的裝置上從上次中斷的地方繼續。如需詳細資訊，請參閱 XBOX Play Anywhere。Game Saves 開發生命週期
Game Saves 開發生命週期一文提供結構化的路徑，協助您建置、驗證及維護可靠且連線至雲端的存檔系統。它會逐步引導您如何將 Game Saves 引入新遊戲，並繼續涵蓋偵錯、測試、認證以及發佈後的支援。每個階段都會強調您所需的需求、工具和最佳做法，以確保您的遊戲能一致地儲存資料、安全地同步資料，並在不同裝置之間提供無縫的使用者體驗。 此生命週期有助於讓您的 Game Saves 實作從第一個原型到發佈及之後都能有可預測的行為。 生命週期一文說明您在規劃、實作、驗證、發佈和維護 Game Saves 時的端對端流程。此生命週期說明如下。- 開始使用 Game Saves： 初步了解 Game Saves 概念、API、儲存模型和平台需求。
- 新遊戲設定： 在開發初期整合 Game Saves。例如：
- 新增相依於使用者登入的初始化。
- 設定識別碼，例如服務設定識別碼 (SCID) 和 Microsoft 帳戶 (MSA) App ID (MSAAppID)。
- 建立您的儲存設計和容器結構。
- 在開發期間偵錯問題： 疑難排解早期實作問題。您可能會遇到下列問題：
- SCID 設定問題
- 控制代碼存留期問題
- 配額/記憶體問題
- NTSTATUS 錯誤解讀
- 測試規劃： 定義結構化的測試計劃。例如，測試下列領域：
- 資料讀取/寫入的正確性
- 離線行為
- 同步邏輯
- 系統對話方塊流程
- 多裝置案例
- 測試案例： 執行詳細的功能和壓力測試。例如，測試您的遊戲在下列情況下的行為。
- 連線變更
- 衝突狀態
- 使用者切換
- 損毀處理
- 儲存空間限制的邊緣案例
- 準備發佈遊戲： 在發佈之前完成 Game Saves 設定。此工作通常包括下列工作：
- 驗證您的 Microsoft Partner Center 設定
- 確認您的遊戲使用正確的配額
- 確保系統對話方塊如預期運作
- 確認您的遊戲使用安全寫入模式
- 認證需求： 符合 XBOX 認證需求。例如，這包括：
- 適當的同步行為。
- 管理連線變更。
- 遵守使用者資料和個人識別資訊 (PII) 規則。
- 管理發佈後的問題： 監視並解決線上網站問題。您可能會遇到下列情況：
- 同步失敗。
- 使用者資料遺失報告。
- 儲存空間限制問題。
- 移轉案例： 案例包括下列項目：
- 更新儲存配置
- 在 Game Saves API 之間移動
- 在遊戲版本之間轉換
Game Saves 文件集
此文件集可協助您了解並實作完整的 Game Saves 生態系統。此文件集說明 API 的運作方式、使用者模型和處理程序生命週期管理 (PLM) 如何塑造您的存檔資料流程，以及儲存系統、配額和離線行為如何影響您的設計。它也提供測試和偵錯的指引、說明使用者可能遇到的系統對話方塊，並概述您在發佈之前需要符合的認證需求。Game Saves 開發人員指南
本文提供 Game Saves 生態系統的概觀，以及重要的開發人員考量，例如可用的 API、使用者模型、PLM、安全性/PII 指引、認證需求，以及儲存空間限制詳細資料。了解 Game Saves 同步流程
本文說明容器/資料夾層級的不可部分完成性 (atomicity) 和六個步驟的同步流程，以及離線模式行為和僅限機器的提供者用法。Game Saves 儲存系統
本文概述各種儲存內容。內容涵蓋 Title storage (雲端)、本機存檔儲存空間和機器提供者儲存空間，以及每個遊戲的配額和主機特定的本機儲存空間詳細資料。Game Saves 系統對話方塊
本文說明使用者在執行 Game Saves 作業時可能遇到的系統對話方塊。Game Saves 逐步解說與範例
本文說明如何設定 Partner Center，以及如何使用安全寫入模式，例如寫入暫存檔案並以不可部分完成的方式取代它。它也說明如何管理離線和離開網路的案例，以及如何使用系統對話方塊流程。此外，它還說明如何管理使用中裝置上的 Game Saves 資料、測試雲端同步行為，以及在遊戲或 API 之間進行移轉。Game Saves 偵錯
本文說明常見的 Game Save 錯誤和疑難排解步驟，包括 SCID 問題、控制代碼存留期最佳做法、配額和記憶體限制，以及如何解讀 Win32NTSTATUS 代碼。
Game Saves 工具
本文說明如何使用 Fiddler 檢查 Game Saves 網路流量。也示範如何使用xbstorage 和 gamesaveutil 命令列工具，在主機和 PC 上匯出或匯入本機存檔資料。
XGameSaveFiles API 概觀
本文說明XGameSaveFilesGetFolderWithUIAsync 的初始化流程、建議的 Win32 自動雲端同步語意、配額/偵錯指引、效能最佳做法，以及常見問題集。