> ## 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 Game Saves 如何讓玩家進度在 XBOX 主機、PC 和掌上型裝置之間保持同步，並依循從設定到上市的開發生命週期。 ## 簡介 Game Saves 讓使用者每次登入時都能取得自己的進度，因此可以在不同裝置之間無縫切換。系統會先將資料儲存在本機，然後在裝置連線到網際網路時將其同步至雲端。同步完成後，使用者就可以在任何支援的裝置上存取其儲存的資料。 ## XBOX Play Anywhere 與 Game Saves XBOX Play Anywhere 使用 Game Saves，讓使用者能在 Windows 裝置、XBOX 主機、PC 和掌上型裝置之間無縫共用遊戲進度。XBOX Play Anywhere 依賴一致的存檔資料同步。使用者可以在任何支援的裝置上從上次中斷的地方繼續。如需詳細資訊，請參閱 [XBOX Play Anywhere](https://www.xbox.com/games/xbox-play-anywhere)。 ## Game Saves 開發生命週期 Game Saves 開發生命週期一文提供結構化的路徑，協助您建置、驗證及維護可靠且連線至雲端的存檔系統。它會逐步引導您如何將 Game Saves 引入新遊戲，並繼續涵蓋偵錯、測試、認證以及發佈後的支援。每個階段都會強調您所需的需求、工具和最佳做法，以確保您的遊戲能一致地儲存資料、安全地同步資料，並在不同裝置之間提供無縫的使用者體驗。 此生命週期有助於讓您的 Game Saves 實作從第一個原型到發佈及之後都能有可預測的行為。 生命週期一文說明您在規劃、實作、驗證、發佈和維護 Game Saves 時的端對端流程。此生命週期說明如下。 1. **開始使用 Game Saves：** 初步了解 Game Saves 概念、API、儲存模型和平台需求。 2. **新遊戲設定：** 在開發初期整合 Game Saves。例如： * 新增相依於使用者登入的初始化。 * 設定識別碼，例如服務設定識別碼 (SCID) 和 Microsoft 帳戶 (MSA) App ID (MSAAppID)。 * 建立您的儲存設計和容器結構。 3. **在開發期間偵錯問題：** 疑難排解早期實作問題。您可能會遇到下列問題： * SCID 設定問題 * 控制代碼存留期問題 * 配額/記憶體問題 * NTSTATUS 錯誤解讀 4. **測試規劃：** 定義結構化的測試計劃。例如，測試下列領域： * 資料讀取/寫入的正確性 * 離線行為 * 同步邏輯 * 系統對話方塊流程 * 多裝置案例 5. **測試案例：** 執行詳細的功能和壓力測試。例如，測試您的遊戲在下列情況下的行為。 * 連線變更 * 衝突狀態 * 使用者切換 * 損毀處理 * 儲存空間限制的邊緣案例 6. **準備發佈遊戲：** 在發佈之前完成 Game Saves 設定。此工作通常包括下列工作： * 驗證您的 Microsoft Partner Center 設定 * 確認您的遊戲使用正確的配額 * 確保系統對話方塊如預期運作 * 確認您的遊戲使用安全寫入模式 7. **認證需求：** 符合 XBOX 認證需求。例如，這包括： * 適當的同步行為。 * 管理連線變更。 * 遵守使用者資料和個人識別資訊 (PII) 規則。 8. **管理發佈後的問題：** 監視並解決線上網站問題。您可能會遇到下列情況： * 同步失敗。 * 使用者資料遺失報告。 * 儲存空間限制問題。 9. **移轉案例：** 案例包括下列項目： * 更新儲存配置 * 在 Game Saves API 之間移動 * 在遊戲版本之間轉換 ## Game Saves 文件集 此文件集可協助您了解並實作完整的 Game Saves 生態系統。此文件集說明 API 的運作方式、使用者模型和處理程序生命週期管理 (PLM) 如何塑造您的存檔資料流程，以及儲存系統、配額和離線行為如何影響您的設計。它也提供測試和偵錯的指引、說明使用者可能遇到的系統對話方塊，並概述您在發佈之前需要符合的認證需求。 ### Game Saves 開發人員指南 本文提供 Game Saves 生態系統的概觀，以及重要的開發人員考量，例如可用的 API、使用者模型、PLM、安全性/PII 指引、認證需求，以及儲存空間限制詳細資料。 * [概觀](/zh-TW/build/core-features/common/game-save/game-saves-developer-guide#overview) * [新遊戲](/zh-TW/build/core-features/common/game-save/game-saves-developer-guide#new-titles) * [Game Saves API](/zh-TW/build/core-features/common/game-save/game-saves-developer-guide#game-saves-apis) * [使用者模型](/zh-TW/build/core-features/common/game-save/game-saves-developer-guide#user-models) * [安全性](/zh-TW/build/core-features/common/game-save/game-saves-developer-guide#security) * [認證需求](/zh-TW/build/core-features/common/game-save/game-saves-developer-guide#certification-requirements) ### 了解 Game Saves 同步流程 本文說明容器/資料夾層級的不可部分完成性 (atomicity) 和六個步驟的同步流程，以及離線模式行為和僅限機器的提供者用法。 * [遊戲啟動](/zh-TW/build/core-features/common/game-save/game-saves-syncing#title-start) * [連線檢查](/zh-TW/build/core-features/common/game-save/game-saves-syncing#connection-check) * [資料擁有權檢查](/zh-TW/build/core-features/common/game-save/game-saves-syncing#data-ownership-check) * [與雲端同步資料](/zh-TW/build/core-features/common/game-save/game-saves-syncing#syncing-data-with-the-cloud) * [遊戲迴圈](/zh-TW/build/core-features/common/game-save/game-saves-syncing#gameplay-loop) * [工作階段結束](/zh-TW/build/core-features/common/game-save/game-saves-syncing#session-end) * [連線中斷與鎖定案例](/zh-TW/build/core-features/common/game-save/game-saves-syncing#connection-loss-and-lock-scenarios) * [電源中斷](/zh-TW/build/core-features/common/game-save/game-saves-syncing#power-loss) ### Game Saves 儲存系統 本文概述各種儲存內容。內容涵蓋 Title storage (雲端)、本機存檔儲存空間和機器提供者儲存空間，以及每個遊戲的配額和主機特定的本機儲存空間詳細資料。 * [Game Saves 儲存系統](/zh-TW/build/core-features/common/game-save/game-saves-storage-systems) * [限制與配額](/zh-TW/build/core-features/common/game-save/game-saves-storage-systems#limits-and-quotas) * [主機特定的本機儲存空間](/zh-TW/build/core-features/common/game-save/game-saves-storage-systems#console-specific-local-storage-system) ### Game Saves 系統對話方塊 本文說明使用者在執行 Game Saves 作業時可能遇到的系統對話方塊。 * [系統對話方塊一覽](/zh-TW/build/core-features/common/game-save/game-saves-dialogues#system-dialogs-at-a-glance) * [Game Saves 對話方塊](/zh-TW/build/core-features/common/game-save/game-saves-dialogues#game-saves-dialogs) ### Game Saves 逐步解說與範例 本文說明如何設定 Partner Center，以及如何使用安全寫入模式，例如寫入暫存檔案並以不可部分完成的方式取代它。它也說明如何管理離線和離開網路的案例，以及如何使用系統對話方塊流程。此外，它還說明如何管理使用中裝置上的 Game Saves 資料、測試雲端同步行為，以及在遊戲或 API 之間進行移轉。 * [Partner Center 設定](/zh-TW/build/core-features/common/game-save/game-saves-walkthroughs-and-samples#partner-center-configurations) * [開發案例](/zh-TW/build/core-features/common/game-save/game-saves-walkthroughs-and-samples#development-scenarios) * [測試案例](/zh-TW/build/core-features/common/game-save/game-saves-walkthroughs-and-samples#testing-scenarios) * [移轉案例](/zh-TW/build/core-features/common/game-save/game-saves-walkthroughs-and-samples#migration-scenarios) * [程式碼範例](/zh-TW/build/core-features/common/game-save/game-saves-walkthroughs-and-samples#code-samples) ### Game Saves 偵錯 本文說明常見的 Game Save 錯誤和疑難排解步驟，包括 SCID 問題、控制代碼存留期最佳做法、配額和記憶體限制，以及如何解讀 Win32 `NTSTATUS` 代碼。 * [常見錯誤案例](/zh-TW/build/core-features/common/game-save/game-saves-debugging#common-game-saves-error-scenarios) * [常見錯誤表](/zh-TW/build/core-features/common/game-save/game-saves-debugging#common-errors) ### Game Saves 工具 本文說明如何使用 Fiddler 檢查 Game Saves 網路流量。也示範如何使用 `xbstorage` 和 `gamesaveutil` 命令列工具，在主機和 PC 上匯出或匯入本機存檔資料。 * [檢查 Game Saves 網路流量](/zh-TW/build/core-features/common/game-save/game-saves-tools#inspecting-game-saves-network-traffic) * [Game Saves 工具](/zh-TW/build/core-features/common/game-save/game-saves-tools) ### XGameSaveFiles API 概觀 本文說明 `XGameSaveFilesGetFolderWithUIAsync` 的初始化流程、建議的 Win32 自動雲端同步語意、配額/偵錯指引、效能最佳做法，以及常見問題集。 * [實作](/zh-TW/build/core-features/common/game-save/xgamesavefiles#implementation-of-xgamesavefiles) * [Game Saves 流程](/zh-TW/build/core-features/common/game-save/xgamesavefiles#game-saves-flow) * [限制與配額](/zh-TW/build/core-features/common/game-save/xgamesavefiles#limits-and-quotas) * [常見問題集](/zh-TW/build/core-features/common/game-save/xgamesavefiles#faqs) ### XGameSave API 概觀 本文說明容器與 Blob 儲存模型、如何初始化和關閉提供者，以及更新控制代碼在其生命週期中的流程。也涵蓋不可部分完成的更新行為、同步流程圖、檔案大小和配額限制、建議的最佳做法，以及常見問題集。 * [實作](/zh-TW/build/core-features/common/game-save/xgamesave#implementation) * [Game Saves 流程](/zh-TW/build/core-features/common/game-save/xgamesave#game-saves-flow) * [限制與配額](/zh-TW/build/core-features/common/game-save/xgamesavefiles#limits-and-quotas) * [最佳做法](/zh-TW/build/core-features/common/game-save/xgamesave#best-practices) * [常見問題集](/zh-TW/build/core-features/common/game-save/xgamesave#faqs) ## Related topics - [Save](/ko/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_save.md) - [Game save](/build/core-features/common/game-save/index.md) - [Game Save](/ja-jp/build/core-features/common/game-save/index.md) - [XGameSave](/reference/system/xgamesave/xgamesave_members.md) - [Game Saves debugging](/build/core-features/common/game-save/game-saves-debugging.md)