> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 服務 C API 概觀 - PFGameSaveFilesUi.h

> 服務 C API 概觀 - PFGameSaveFilesUi.h

## 函式

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

## 結構

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

## 狀態變更

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

## 列舉

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


## Related topics

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