> ## 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-CN/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuiactivedevicecontentionresponse.md) | 设置 PFGameSaveFilesUiActiveDeviceContentionCallback 的用户响应。可以在回调内部或外部调用此函数。在用户选择响应或异步 API 被取消之前，状态机不会继续推进。 |
| [PFGameSaveFilesSetUiCallbacks](https://docs.xbox.com/zh-CN/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-CN/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuiconflictresponse.md) | 设置 PFGameSaveFilesUiConflictCallback 的用户响应。可以在回调内部或外部调用此函数。在用户选择响应或异步 API 被取消之前，状态机不会继续推进。 |
| [PFGameSaveFilesSetUiOutOfStorageResponse](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuioutofstorageresponse.md) | 设置 PFGameSaveFilesUiOutOfStorageCallback 的用户响应。可以在回调内部或外部调用此函数。在用户选择响应或异步 API 被取消之前，状态机不会继续推进。 |
| [PFGameSaveFilesSetUiProgressResponse](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuiprogressresponse.md) | 设置 PFGameSaveFilesUiProgressCallback 的用户响应。可以在回调内部或外部调用此函数。在用户选择响应或异步 API 被取消之前，状态机不会继续推进。 |
| [PFGameSaveFilesSetUiSyncFailedResponse](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilessetuisyncfailedresponse.md) | 设置 PFGameSaveFilesUiSyncFailedCallback 的用户响应。可以在回调内部或外部调用此函数。在用户选择响应或异步 API 被取消之前，状态机不会继续推进。 |
| [PFGameSaveFilesUiActiveDeviceContentionCallback](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuiactivedevicecontentioncallback.md) | 活动设备争用回调。 |
| [PFGameSaveFilesUiConflictCallback](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuiconflictcallback.md) | 冲突回调。 |
| [PFGameSaveFilesUiOutOfStorageCallback](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuioutofstoragecallback.md) | 本地设备存储空间不足时触发的回调。 |
| [PFGameSaveFilesUiProgressCallback](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuiprogresscallback.md) | 当同步操作转换到新状态时触发的通知回调。此回调在每次状态转换时触发一次（例如，PreparingForUpload 触发一次，Uploading 触发一次），而不会随着状态内进度的推进而重复触发。若要获取状态内的细粒度进度，请调用 PFGameSaveFilesUiProgressGetProgress 轮询当前字节数和总字节数。游戏应将其视为状态更改通知（例如，显示或更新进度对话框），而不应期望它高频触发。 |
| [PFGameSaveFilesUiProgressGetProgress](https://docs.xbox.com/zh-CN/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-CN/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuisyncfailedcallback.md) | 同步失败回调。 |

## 结构

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

## 状态更改

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

## 枚举

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


## Related topics

- [服务 C API 概览 - PFGameSaveFiles.h](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfgamesavefiles/pfgamesavefiles_members.md)
- [服务 C API 概览 - PFGameSaveFilesTypes.h](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfgamesavefilestypes/pfgamesavefilestypes_members.md)
- [PFGameSaveFilesUiProgressCallback](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuiprogresscallback.md)
- [PFGameSaveFilesUiConflictCallback](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/functions/pfgamesavefilesuiconflictcallback.md)
- [PFGameSaveFilesUiConflictUserAction](https://docs.xbox.com/zh-CN/services/playfab/api-references/c/pfgamesavefilesui/enums/pfgamesavefilesuiconflictuseraction.md)