函数
| 函数 | 说明 |
|---|---|
| PFGameSaveFilesSetUiActiveDeviceContentionResponse | 设置 PFGameSaveFilesUiActiveDeviceContentionCallback 的用户响应。可以在回调内部或外部调用此函数。在用户选择响应或异步 API 被取消之前,状态机不会继续推进。 |
| PFGameSaveFilesSetUiCallbacks | 设置 UI 回调。这些 UI 回调将在 PFGameSaveFilesAddUserWithUiAsync() 或 PFGameSaveFilesUploadWithUiAsync() 期间触发。PFGameSaveFilesAddUserWithUiAsync() 可能触发任何 UI 回调,而 PFGameSaveFilesUploadWithUiAsync() 仅会触发 PFGameSaveFilesUiProgressCallback 和/或 PFGameSaveFilesUiSyncFailedCallback。在非 Windows 平台上,必须设置这些回调才能触发由游戏呈现的 UI 对话框。在 XBOX 和 Windows 平台上,文件同步在进程外完成,并由平台提供默认 UI,但游戏可以根据需要设置这些回调来呈现自定义 UI 对话框。 |
| PFGameSaveFilesSetUiConflictResponse | 设置 PFGameSaveFilesUiConflictCallback 的用户响应。可以在回调内部或外部调用此函数。在用户选择响应或异步 API 被取消之前,状态机不会继续推进。 |
| PFGameSaveFilesSetUiOutOfStorageResponse | 设置 PFGameSaveFilesUiOutOfStorageCallback 的用户响应。可以在回调内部或外部调用此函数。在用户选择响应或异步 API 被取消之前,状态机不会继续推进。 |
| PFGameSaveFilesSetUiProgressResponse | 设置 PFGameSaveFilesUiProgressCallback 的用户响应。可以在回调内部或外部调用此函数。在用户选择响应或异步 API 被取消之前,状态机不会继续推进。 |
| PFGameSaveFilesSetUiSyncFailedResponse | 设置 PFGameSaveFilesUiSyncFailedCallback 的用户响应。可以在回调内部或外部调用此函数。在用户选择响应或异步 API 被取消之前,状态机不会继续推进。 |
| PFGameSaveFilesUiActiveDeviceContentionCallback | 活动设备争用回调。 |
| PFGameSaveFilesUiConflictCallback | 冲突回调。 |
| PFGameSaveFilesUiOutOfStorageCallback | 本地设备存储空间不足时触发的回调。 |
| PFGameSaveFilesUiProgressCallback | 当同步操作转换到新状态时触发的通知回调。此回调在每次状态转换时触发一次(例如,PreparingForUpload 触发一次,Uploading 触发一次),而不会随着状态内进度的推进而重复触发。若要获取状态内的细粒度进度,请调用 PFGameSaveFilesUiProgressGetProgress 轮询当前字节数和总字节数。游戏应将其视为状态更改通知(例如,显示或更新进度对话框),而不应期望它高频触发。 |
| PFGameSaveFilesUiProgressGetProgress | 获取同步操作的当前进度。可在 PFGameSaveFilesUiProgressCallback 内调用此函数,或在同步进行期间定期轮询,以获取最新的字节级进度。在 PreparingForUpload 期间,current/total 表示已处理/预期的未压缩字节数。在 Uploading 期间,current/total 表示已传输/预期的未压缩字节数。在 Downloading 期间,current/total 表示已下载/预期的字节数。如果 total 为 0,则表示总大小尚未确定,游戏应将其视为不确定进度(例如,显示旋转图标),而不是除以零或显示 0%。 |
| PFGameSaveFilesUiSyncFailedCallback | 同步失败回调。 |
结构
| 结构 | 说明 |
|---|---|
| PFGameSaveUICallbacks | 游戏存档操作的 UI 回调。 |
状态更改
| 状态更改 | 说明 |
|---|
枚举
| 枚举 | 说明 |
|---|---|
| PFGameSaveFilesUiActiveDeviceContentionUserAction | PFGameSaveFilesUiActiveDeviceContentionCallback 的用户操作。 |
| PFGameSaveFilesUiConflictUserAction | PFGameSaveFilesUiConflictCallback 的用户操作。 |
| PFGameSaveFilesUiOutOfStorageUserAction | PFGameSaveFilesUiOutOfStorageCallback 的用户操作。 |
| PFGameSaveFilesUiProgressUserAction | PFGameSaveFilesUiProgressCallback 的用户操作。 |
| PFGameSaveFilesUiSyncFailedUserAction | PFGameSaveFilesUiSyncFailedCallback 的用户操作。 |
