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