> ## 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 概觀 - PFGameSaveFilesUi.h

> 服務 C API 概觀 - PFGameSaveFilesUi.h

## 函式

| 函式 | 說明 |
| - | - |
| [PFGameSaveFilesSetUiActiveDeviceContentionResponse](/zh-TW/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuiactivedevicecontentionresponse) | 設定 PFGameSaveFilesUiActiveDeviceContentionCallback 的使用者回應。此函式可在回呼內部或外部呼叫。在使用者選擇回應或非同步 API 遭到取消之前，狀態機器不會繼續進行。 |
| [PFGameSaveFilesSetUiCallbacks](/zh-TW/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuicallbacks) | 設定 UI 回呼。這些 UI 回呼會在 PFGameSaveFilesAddUserWithUiAsync() 或 PFGameSaveFilesUploadWithUiAsync() 期間觸發。PFGameSaveFilesAddUserWithUiAsync() 可能觸發任何 UI 回呼，而 PFGameSaveFilesUploadWithUiAsync() 只會觸發 PFGameSaveFilesUiProgressCallback 和/或 PFGameSaveFilesUiSyncFailedCallback。在非 Windows 平台上，必須設定這些回呼才能觸發由遊戲轉譯的 UI 對話方塊。在 XBOX 和 Windows 平台上，檔案同步會在處理程序外完成，且平台會提供內建 UI，不過遊戲可以視需要設定這些回呼來轉譯自訂 UI 對話方塊。 |
| [PFGameSaveFilesSetUiConflictResponse](/zh-TW/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuiconflictresponse) | 設定 PFGameSaveFilesUiConflictCallback 的使用者回應。此函式可在回呼內部或外部呼叫。在使用者選擇回應或非同步 API 遭到取消之前，狀態機器不會繼續進行。 |
| [PFGameSaveFilesSetUiOutOfStorageResponse](/zh-TW/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuioutofstorageresponse) | 設定 PFGameSaveFilesUiOutOfStorageCallback 的使用者回應。此函式可在回呼內部或外部呼叫。在使用者選擇回應或非同步 API 遭到取消之前，狀態機器不會繼續進行。 |
| [PFGameSaveFilesSetUiProgressResponse](/zh-TW/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuiprogressresponse) | 設定 PFGameSaveFilesUiProgressCallback 的使用者回應。此函式可在回呼內部或外部呼叫。在使用者選擇回應或非同步 API 遭到取消之前，狀態機器不會繼續進行。 |
| [PFGameSaveFilesSetUiSyncFailedResponse](/zh-TW/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuisyncfailedresponse) | 設定 PFGameSaveFilesUiSyncFailedCallback 的使用者回應。此函式可在回呼內部或外部呼叫。在使用者選擇回應或非同步 API 遭到取消之前，狀態機器不會繼續進行。 |
| [PFGameSaveFilesUiActiveDeviceContentionCallback](/zh-TW/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuiactivedevicecontentioncallback) | 作用中裝置爭用回呼。 |
| [PFGameSaveFilesUiConflictCallback](/zh-TW/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuiconflictcallback) | 衝突回呼。 |
| [PFGameSaveFilesUiOutOfStorageCallback](/zh-TW/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuioutofstoragecallback) | 本機裝置儲存空間不足時觸發的回呼。 |
| [PFGameSaveFilesUiProgressCallback](/zh-TW/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuiprogresscallback) | 同步作業轉換到新狀態時觸發的通知回呼。此回呼在每次狀態轉換時觸發一次 (例如，PreparingForUpload 一次、Uploading 一次)，而不會隨著狀態內的進度推進而重複觸發。若要取得狀態內的細部進度，請呼叫 PFGameSaveFilesUiProgressGetProgress 以輪詢目前和總位元組數。遊戲應將此視為狀態變更通知 (例如，顯示或更新進度對話方塊)，而不應預期它會高頻率觸發。 |
| [PFGameSaveFilesUiProgressGetProgress](/zh-TW/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuiprogressgetprogress) | 取得同步作業的目前進度。請從 PFGameSaveFilesUiProgressCallback 內呼叫此函式，或在同步進行期間定期輪詢，以取得最新的位元組層級進度。在 PreparingForUpload 期間，current/total 反映已處理/預期的未壓縮位元組數。在 Uploading 期間，current/total 反映已傳輸/預期的未壓縮位元組數。在 Downloading 期間，current/total 反映已下載/預期的位元組數。如果 total 為 0，表示總大小尚未得知，遊戲應將此視為不確定進度 (例如，顯示旋轉圖示)，而不是除以零或顯示 0%。 |
| [PFGameSaveFilesUiSyncFailedCallback](/zh-TW/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuisyncfailedcallback) | 同步失敗回呼。 |

## 結構

| 結構 | 說明 |
| - | - |
| [PFGameSaveUICallbacks](/zh-TW/services/playfab/api-references/c/pfgamesavefilesui/structs/pfgamesaveuicallbacks) | 遊戲存檔作業的 UI 回呼。 |

## 狀態變更

| 狀態變更 | 說明 |
| - | - |

## 列舉

| 列舉 | 說明 |
| - | - |
| [PFGameSaveFilesUiActiveDeviceContentionUserAction](/zh-TW/services/playfab/api-references/c/pfgamesavefilesui/enums/pfgamesavefilesuiactivedevicecontentionuseraction) | PFGameSaveFilesUiActiveDeviceContentionCallback 的使用者動作。 |
| [PFGameSaveFilesUiConflictUserAction](/zh-TW/services/playfab/api-references/c/pfgamesavefilesui/enums/pfgamesavefilesuiconflictuseraction) | PFGameSaveFilesUiConflictCallback 的使用者動作。 |
| [PFGameSaveFilesUiOutOfStorageUserAction](/zh-TW/services/playfab/api-references/c/pfgamesavefilesui/enums/pfgamesavefilesuioutofstorageuseraction) | PFGameSaveFilesUiOutOfStorageCallback 的使用者動作。 |
| [PFGameSaveFilesUiProgressUserAction](/zh-TW/services/playfab/api-references/c/pfgamesavefilesui/enums/pfgamesavefilesuiprogressuseraction) | PFGameSaveFilesUiProgressCallback 的使用者動作。 |
| [PFGameSaveFilesUiSyncFailedUserAction](/zh-TW/services/playfab/api-references/c/pfgamesavefilesui/enums/pfgamesavefilesuisyncfaileduseraction) | PFGameSaveFilesUiSyncFailedCallback 的使用者動作。 |


## Related topics

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