> ## 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-CN/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuiactivedevicecontentionresponse) | 设置 PFGameSaveFilesUiActiveDeviceContentionCallback 的用户响应。可以在回调内部或外部调用此函数。在用户选择响应或异步 API 被取消之前，状态机不会继续推进。 |
| [PFGameSaveFilesSetUiCallbacks](/zh-CN/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-CN/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuiconflictresponse) | 设置 PFGameSaveFilesUiConflictCallback 的用户响应。可以在回调内部或外部调用此函数。在用户选择响应或异步 API 被取消之前，状态机不会继续推进。 |
| [PFGameSaveFilesSetUiOutOfStorageResponse](/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuioutofstorageresponse) | 设置 PFGameSaveFilesUiOutOfStorageCallback 的用户响应。可以在回调内部或外部调用此函数。在用户选择响应或异步 API 被取消之前，状态机不会继续推进。 |
| [PFGameSaveFilesSetUiProgressResponse](/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuiprogressresponse) | 设置 PFGameSaveFilesUiProgressCallback 的用户响应。可以在回调内部或外部调用此函数。在用户选择响应或异步 API 被取消之前，状态机不会继续推进。 |
| [PFGameSaveFilesSetUiSyncFailedResponse](/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuisyncfailedresponse) | 设置 PFGameSaveFilesUiSyncFailedCallback 的用户响应。可以在回调内部或外部调用此函数。在用户选择响应或异步 API 被取消之前，状态机不会继续推进。 |
| [PFGameSaveFilesUiActiveDeviceContentionCallback](/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuiactivedevicecontentioncallback) | 活动设备争用回调。 |
| [PFGameSaveFilesUiConflictCallback](/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuiconflictcallback) | 冲突回调。 |
| [PFGameSaveFilesUiOutOfStorageCallback](/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuioutofstoragecallback) | 本地设备存储空间不足时触发的回调。 |
| [PFGameSaveFilesUiProgressCallback](/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuiprogresscallback) | 当同步操作转换到新状态时触发的通知回调。此回调在每次状态转换时触发一次（例如，PreparingForUpload 触发一次，Uploading 触发一次），而不会随着状态内进度的推进而重复触发。若要获取状态内的细粒度进度，请调用 PFGameSaveFilesUiProgressGetProgress 轮询当前字节数和总字节数。游戏应将其视为状态更改通知（例如，显示或更新进度对话框），而不应期望它高频触发。 |
| [PFGameSaveFilesUiProgressGetProgress](/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuiprogressgetprogress) | 获取同步操作的当前进度。可在 PFGameSaveFilesUiProgressCallback 内调用此函数，或在同步进行期间定期轮询，以获取最新的字节级进度。在 PreparingForUpload 期间，current/total 表示已处理/预期的未压缩字节数。在 Uploading 期间，current/total 表示已传输/预期的未压缩字节数。在 Downloading 期间，current/total 表示已下载/预期的字节数。如果 total 为 0，则表示总大小尚未确定，游戏应将其视为不确定进度（例如，显示旋转图标），而不是除以零或显示 0%。 |
| [PFGameSaveFilesUiSyncFailedCallback](/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuisyncfailedcallback) | 同步失败回调。 |

## 结构

| 结构 | 说明 |
| - | - |
| [PFGameSaveUICallbacks](/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/structs/pfgamesaveuicallbacks) | 游戏存档操作的 UI 回调。 |

## 状态更改

| 状态更改 | 说明 |
| - | - |

## 枚举

| 枚举 | 说明 |
| - | - |
| [PFGameSaveFilesUiActiveDeviceContentionUserAction](/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/enums/pfgamesavefilesuiactivedevicecontentionuseraction) | PFGameSaveFilesUiActiveDeviceContentionCallback 的用户操作。 |
| [PFGameSaveFilesUiConflictUserAction](/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/enums/pfgamesavefilesuiconflictuseraction) | PFGameSaveFilesUiConflictCallback 的用户操作。 |
| [PFGameSaveFilesUiOutOfStorageUserAction](/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/enums/pfgamesavefilesuioutofstorageuseraction) | PFGameSaveFilesUiOutOfStorageCallback 的用户操作。 |
| [PFGameSaveFilesUiProgressUserAction](/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/enums/pfgamesavefilesuiprogressuseraction) | PFGameSaveFilesUiProgressCallback 的用户操作。 |
| [PFGameSaveFilesUiSyncFailedUserAction](/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/enums/pfgamesavefilesuisyncfaileduseraction) | PFGameSaveFilesUiSyncFailedCallback 的用户操作。 |


## Related topics

- [服务 C API 概览 - PFGameSaveFiles.h](/zh-CN/services/playfab/api-references/c/pfgamesavefiles/pfgamesavefiles_members.md)
- [服务 C API 概览 - PFGameSaveFilesTypes.h](/zh-CN/services/playfab/api-references/c/pfgamesavefilestypes/pfgamesavefilestypes_members.md)
- [PFGameSaveFilesUiConflictCallback](/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuiconflictcallback.md)
- [PFGameSaveFilesUiProgressCallback](/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuiprogresscallback.md)
- [PFGameSaveFilesUiOutOfStorageCallback](/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuioutofstoragecallback.md)