> ## 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 概觀

> PlayFab Game Saves 的概觀，這是一項跨裝置的雲端存檔服務，可在工作階段和平台之間儲存、同步和還原玩家進度。

## 什麼是 Game Saves

透過使用 Game Saves，玩家在跨平台、裝置和商店切換時，可以在進度完整保留的情況下繼續遊戲。Game Saves 會處理檔案同步和衝突解決。它可協助玩家維持單一進度點，並完全支援離線遊玩。

### 優點

* 將玩家進度連結至您的遊戲，而不是個別裝置或平台。
* 消除實作跨平台同步的複雜度。
* 支援線上和離線遊玩，並可控制這些狀態之間的轉換。
* 將版本衝突的機會降至最低。
* 協助玩家在裝置和平台之間順暢轉換，以維持一致的進度點。
* 在需要時提供內容提示，協助玩家做出明智的衝突解決和單一進度點決策。
* 透過版本回復支援，讓玩家從不良狀態中復原。
* 發出 [PlayStream 事件](/zh-TW/services/playfab/player-progression/game-saves/playstream-events)，用於追蹤玩家群中的存檔活動、衝突和回復。
* 在可用的情況下，搭配背景上傳程式和遊戲可呼叫的 UI 運作。

### 目前支援的遊戲平台

* XBOX (One、Series S/X、PC、雲端)
* Steam (PC、Steam Deck)
* Windows (其他商店和啟動器)
* PlayStation 5

### 目前支援的語言和遊戲引擎

* C++
* Unreal Engine

## 範例實作

GitHub 上提供 Windows 的端對端參考實作，示範初始化、雲端同步 (下載/上傳)、衝突處理、作用中裝置管理和 UI 回呼：

[Game Saves 範例 – PlayFabGameSaveSample-Windows](https://github.com/PlayFab/PlayFab-Samples/tree/master/Samples/All/PlayFabGameSaveSample-Windows)

使用此範例可以：

* 在內容中查看初始化、新增使用者和上傳作業的順序。
* 檢閱最少的錯誤處理模式和 UI 回呼連接。
* 在將 API 整合至您的生產專案之前快速進行實驗。

## 實作需求

### 驗證需求

* **身分識別連結**：為了確保遊戲存檔能在平台之間順暢轉換，遊戲必須使用共用或連結的使用者身分識別。PlayFab 支援兩個已驗證提供者之間的帳戶連結。

### 平台特定考量

* **非 XBOX/Windows 平台**：在 Windows 和 XBOX 以外的平台上 (例如 Steam Deck)，遊戲必須提供 UI。Game Saves 會觸發遊戲可以回應的 UI 回呼。

* **非 XBOX/Windows 平台上的上傳處理**：在 Windows 和 XBOX 以外的平台上 (例如 Steam Deck)，Game Saves 上傳會在與遊戲相同的處理序中進行。這表示遊戲必須警告使用者在上傳完成之前不要結束，否則遊戲存檔將無法到達雲端。

### 多平台部署

* **跨商店相容性**：計畫在多個商店推出的遊戲，應考量未同步進行的遊戲更新會如何影響共用的雲端遊戲存檔資料。

* **穩健的存檔實作**：雖然不是必要的，但為了獲得最高的可靠性，遊戲應實作雙重緩衝做法，在兩個本機磁碟存檔檔案之間交替使用，以確保在寫入作業失敗時，一律有已知良好的後援。此最佳做法與雲端存檔無關，有助於防止遊戲異常終止期間的存檔損毀。


## Related topics

- [Game Saves 概觀](/zh-TW/build/core-features/common/game-save/game-saves-overview.md)
- [XGameSave API 概觀](/zh-TW/build/core-features/common/game-save/xgamesave.md)
- [XGameSaveFiles API 概觀](/zh-TW/build/core-features/common/game-save/xgamesavefiles.md)
- [服務 C API 概觀 - PFGameSaveFiles.h](/zh-TW/services/playfab/api-references/c/pfgamesavefiles/pfgamesavefiles_members.md)
- [服務 C API 概觀 - PFGameSaveFilesUi.h](/zh-TW/services/playfab/api-references/c/pfgamesavefilesui/pfgamesavefilesui_members.md)