跳轉到主要內容
將使用者新增至遊戲存檔系統。這會視需要從雲端下載存檔狀態,並可能觸發下列 UI 回呼:PFGameSaveFilesUiProgressCallback、PFGameSaveFilesUiSyncFailedCallback、PFGameSaveFilesUiActiveDeviceContentionCallback、PFGameSaveFilesUiConflictCallback、PFGameSaveFilesUiOutOfStorageCallback。如需詳細資訊,請參閱 PFGameSaveFilesSetUiCallbacks。必須先呼叫 PFGameSaveFilesInitialize。在 XBOX 和 Windows 平台上,系統會提供內建 UI。

語法

參數

localUserHandle PFLocalUserHandle 要新增的本機使用者。 options PFGameSaveFilesAddUserOptions 新增使用者時要使用的選項。 async XAsyncBlock*
Inout
用於輪詢呼叫狀態及擷取呼叫結果的 XAsyncBlock。

傳回值

類型:HRESULT 若要擷取 PFGameSaveFilesAddUserWithUiAsync 呼叫的結果,請呼叫 PFGameSaveFilesAddUserWithUiResult。此呼叫完成後,您可以呼叫 PFGameSaveFilesGetFolder 以取得此使用者之遊戲存檔檔案和資料夾的根資料夾。根資料夾的所有檔案和子資料夾都會與雲端同步。每位使用者只能呼叫一次,通常是在顯示遊戲主功能表之前。若要為同一位使用者重新觸發下載,請先呼叫 PFGameSaveFilesUninitializeAsync 並等候其完成

需求

標頭: PFGameSaveFiles.h

另請參閱

PFGameSaveFiles 成員
最後修改於 2026年10月6日