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

# 服務 C API 概觀 - PFGameSaveFiles.h

> 服務 C API 概觀 - PFGameSaveFiles.h

## 函式

| 函式 | 說明 |
| - | - |
| [PFGameSaveFilesActiveDeviceChangedCallback](/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesactivedevicechangedcallback) | 作用中裝置變更時的回呼。觸發此回呼時，表示使用者已移至另一部裝置，因此此遊戲應返回主功能表 |
| [PFGameSaveFilesAddUserWithUiAsync](/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesadduserwithuiasync) | 將使用者新增至遊戲存檔系統。這會視需要從雲端下載存檔狀態，且可能會觸發下列 UI 回呼：PFGameSaveFilesUiProgressCallback、PFGameSaveFilesUiSyncFailedCallback、PFGameSaveFilesUiActiveDeviceContentionCallback、PFGameSaveFilesUiConflictCallback、PFGameSaveFilesUiOutOfStorageCallback。如需更多詳細資料，請參閱 PFGameSaveFilesSetUiCallbacks。必須先呼叫 PFGameSaveFilesInitialize。在 XBOX 和 Windows 平台上，由系統提供內建 UI。 |
| [PFGameSaveFilesAddUserWithUiResult](/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesadduserwithuiresult) | 擷取呼叫 PFGameSaveFilesAddUserWithUiAsync 的結果。 |
| [PFGameSaveFilesGetFolder](/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesgetfolder) | 傳回此使用者遊戲存檔檔案和資料夾的根資料夾。其所有檔案和子資料夾都會與雲端同步。必須先使用 PFGameSaveFilesAddUserWithUiAsync 新增使用者。 |
| [PFGameSaveFilesGetFolderSize](/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesgetfoldersize) | 傳回此使用者遊戲存檔檔案和資料夾之根資料夾的大小 (以位元組為單位)。必須先使用 PFGameSaveFilesAddUserWithUiAsync 新增使用者。 |
| [PFGameSaveFilesGetRemainingQuota](/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesgetremainingquota) | 傳回可使用 PFGameSaveFiles API 儲存存檔資料的可用資料量 (以位元組為單位)。超過配額時會傳回負數，並導致服務封鎖上傳。 |
| [PFGameSaveFilesInitialize](/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesinitialize) | 初始化 PlayFab Game Save 程式庫執行個體。 |
| [PFGameSaveFilesIsConnectedToCloud](/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesisconnectedtocloud) | 傳回使用者是否已連線至雲端。在沒有網路存取的情況下呼叫 PFGameSaveFilesAddUserWithUiAsync()，且使用者在 PFGameSaveFilesUiSyncFailedCallback 中選擇 PFGameSaveFilesUiSyncFailedUserAction::UseOffline 時，使用者可能會與雲端中斷連線。如果另一部裝置成為作用中裝置，使用者也可能隨時與雲端中斷連線。與雲端中斷連線時，如果您想嘗試連線至雲端，可以再次呼叫 PFGameSaveFilesAddUserWithUiAsync()。如果網路仍處於離線狀態，則會再次顯示失敗 UI。不需要重新初始化 gamesave，但您可以視需要這麼做。與雲端中斷連線時，即使有網路存取，PFGameSaveFilesUploadWithUiAsync() 也不會執行任何動作，而只會在非同步完成中傳回 E\_PF\_GAMESAVE\_DISCONNECTED\_FROM\_CLOUD。 |
| [PFGameSaveFilesResetCloudAsync](/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesresetcloudasync) | 這會重設此使用者的雲端遊戲存檔狀態。通常不需要呼叫此函式，但在開發或測試期間可能很有用。這不會刪除或變更本機遊戲存檔。 |
| [PFGameSaveFilesResetCloudResult](/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesresetcloudresult) | 擷取呼叫 PFGameSaveFilesResetCloudAsync 的結果。 |
| [PFGameSaveFilesSetActiveDeviceChangedCallback](/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilessetactivedevicechangedcallback) | 設定作用中裝置變更回呼。觸發此回呼時，表示使用者已移至另一部裝置，因此此遊戲應返回主功能表 |
| [PFGameSaveFilesSetSaveDescriptionAsync](/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilessetsavedescriptionasync) | 設定擱置中遊戲存檔的簡短存檔描述。這會顯示在衝突或作用中裝置爭用 UI 中 |
| [PFGameSaveFilesSetSaveDescriptionResult](/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilessetsavedescriptionresult) | 擷取呼叫 PFGameSaveFilesSetSaveDescriptionAsync 的結果。 |
| [PFGameSaveFilesUninitializeAsync](/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesuninitializeasync) | 清除 PlayFab Game Save 程式庫執行個體。 |
| [PFGameSaveFilesUninitializeResult](/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesuninitializeresult) | 擷取呼叫 PFGameSaveFilesUninitializeAsync 的結果。 |
| [PFGameSaveFilesUploadWithUiAsync](/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesuploadwithuiasync) | 上傳 PFGameSaveFilesGetFolder() 所傳回之資料夾中的所有檔案和資料夾。必須先新增使用者。在非 Windows 平台上，上傳會在與遊戲相同的處理序中進行，且可能會觸發下列 UI 回呼：PFGameSaveFilesUiProgressCallback、PFGameSaveFilesUiSyncFailedCallback。在 XBOX 和 Windows 平台上，上傳會在處理序外完成，並由系統提供內建 UI。在 XBOX 和 Windows 平台上，呼叫此 API 是選擇性的，因為上傳會在遊戲未執行時自動進行。 |
| [PFGameSaveFilesUploadWithUiResult](/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesuploadwithuiresult) | 擷取呼叫 PFGameSaveFilesUploadWithUiAsync 的結果。 |


## Related topics

- [服務 C API 概觀 - PFGameSaveFilesTypes.h](/zh-TW/services/playfab/api-references/c/pfgamesavefilestypes/pfgamesavefilestypes_members.md)
- [服務 C API 概觀 - PFGameSaveFilesUi.h](/zh-TW/services/playfab/api-references/c/pfgamesavefilesui/pfgamesavefilesui_members.md)
- [Game Saves 概觀](/zh-TW/build/core-features/common/game-save/game-saves-overview.md)
- [XGameSaveFiles API 概觀](/zh-TW/build/core-features/common/game-save/xgamesavefiles.md)
- [PFGameSaveFilesInitialize](/zh-TW/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesinitialize.md)