函数
| 函数 | 说明 |
|---|---|
| PFGameSaveFilesActiveDeviceChangedCallback | 活动设备更改时的回调。触发此回调时,表示用户已移至另一台设备,因此此游戏应返回主菜单 |
| PFGameSaveFilesAddUserWithUiAsync | 将用户添加到游戏存档系统。这会根据需要从云下载存档状态,并可能触发以下 UI 回调:PFGameSaveFilesUiProgressCallback、PFGameSaveFilesUiSyncFailedCallback、PFGameSaveFilesUiActiveDeviceContentionCallback、PFGameSaveFilesUiConflictCallback、PFGameSaveFilesUiOutOfStorageCallback。有关更多详细信息,请参阅 PFGameSaveFilesSetUiCallbacks。必须事先调用 PFGameSaveFilesInitialize。在 XBOX 和 Windows 平台上,由系统提供标准 UI。 |
| PFGameSaveFilesAddUserWithUiResult | 获取对 PFGameSaveFilesAddUserWithUiAsync 的调用结果。 |
| PFGameSaveFilesGetFolder | 返回此用户的游戏存档文件和文件夹的根文件夹。其所有文件和子文件夹都将与云同步。必须先使用 PFGameSaveFilesAddUserWithUiAsync 添加用户。 |
| PFGameSaveFilesGetFolderSize | 返回此用户的游戏存档文件和文件夹的根文件夹大小(以字节为单位)。必须先使用 PFGameSaveFilesAddUserWithUiAsync 添加用户。 |
| PFGameSaveFilesGetRemainingQuota | 返回可使用 PFGameSaveFiles API 存储存档数据的可用数据量(以字节为单位)。超出配额将返回负数,并导致服务阻止上传。 |
| PFGameSaveFilesInitialize | 初始化 PlayFab Game Save 库实例。 |
| PFGameSaveFilesIsConnectedToCloud | 返回用户是否已连接到云。在没有网络访问的情况下调用 PFGameSaveFilesAddUserWithUiAsync(),且用户在 PFGameSaveFilesUiSyncFailedCallback 中选择 PFGameSaveFilesUiSyncFailedUserAction::UseOffline 时,用户可能会与云断开连接。如果另一台设备成为活动设备,用户也可能随时与云断开连接。与云断开连接后,如果想要尝试连接到云,可以再次调用 PFGameSaveFilesAddUserWithUiAsync()。如果网络仍处于脱机状态,将再次显示失败 UI。无需重新初始化 gamesave,但如果需要也可以这样做。与云断开连接时,即使有网络访问,PFGameSaveFilesUploadWithUiAsync() 也不会执行任何操作,而是在异步完成中返回 E_PF_GAMESAVE_DISCONNECTED_FROM_CLOUD。 |
| PFGameSaveFilesResetCloudAsync | 这会重置此用户的云游戏存档状态。通常无需调用此函数,但在开发或测试期间可能很有用。这不会删除或更改本地游戏存档。 |
| PFGameSaveFilesResetCloudResult | 获取对 PFGameSaveFilesResetCloudAsync 的调用结果。 |
| PFGameSaveFilesSetActiveDeviceChangedCallback | 设置活动设备更改回调。触发此回调时,表示用户已移至另一台设备,因此此游戏应返回主菜单 |
| PFGameSaveFilesSetSaveDescriptionAsync | 设置待处理游戏存档的简短存档说明。可在冲突或活动设备争用 UI 中看到此说明 |
| PFGameSaveFilesSetSaveDescriptionResult | 获取对 PFGameSaveFilesSetSaveDescriptionAsync 的调用结果。 |
| PFGameSaveFilesUninitializeAsync | 清理 PlayFab Game Save 库实例。 |
| PFGameSaveFilesUninitializeResult | 获取对 PFGameSaveFilesUninitializeAsync 的调用结果。 |
| PFGameSaveFilesUploadWithUiAsync | 上传 PFGameSaveFilesGetFolder() 返回的文件夹中的所有文件和文件夹。必须先添加用户。在非 Windows 平台上,上传在游戏所在的同一进程中进行,并可能触发以下 UI 回调:PFGameSaveFilesUiProgressCallback、PFGameSaveFilesUiSyncFailedCallback。在 XBOX 和 Windows 平台上,上传在进程外完成,并由系统提供标准 UI。在 XBOX 和 Windows 平台上,调用此 API 是可选的,因为上传会在游戏未运行时自动进行。 |
| PFGameSaveFilesUploadWithUiResult | 获取对 PFGameSaveFilesUploadWithUiAsync 的调用结果。 |
