函式
| 函式 | 說明 |
|---|---|
| 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 的使用者動作。 |
