跳轉到主要內容
將非同步作業排入佇列,以擷取 PlayFab 實體識別碼與已知 XBOX Live 使用者識別碼之間的對應清單。

語法

參數

xboxLiveUserIdCount   uint32_t xboxLiveUserIds 陣列中的 XBOX Live 使用者識別碼數目。 xboxLiveUserIds   uint64_t*
大小為 xboxLiveUserIdCount 的輸入陣列
大小為 xboxLiveUserIdCount 的陣列,包含程式庫要查詢其 PlayFab 實體識別碼的 XBOX Live 使用者識別碼。 localChatUser   PartyXblLocalChatUser* 將用來與 PlayFab 通訊的本機聊天使用者。如有需要,本機聊天使用者會登入 PlayFab。 asyncIdentifier   void*
選用
選用的應用程式定義指標大小內容值,可用來將完成狀態變更與此呼叫建立關聯。

傳回值

PartyError 如果作業已啟動,則為 c_partyErrorSuccess;否則為錯誤碼。可透過 GetErrorMessage() 擷取錯誤碼的人類可讀形式。

備註

只有在 XBOX Live 使用者已連結至 PlayFab 帳戶時,每個 XBOX Live 使用者識別碼才會對應至 PlayFab 實體識別碼。第一次呼叫 PartyXblManager::LoginToPlayFab 時,會自動建立並連結 PlayFab 帳戶。PlayFab SDK 提供的 LoginWithXbox API 也可用來連結帳戶。

如果與此呼叫完成相關聯的 PartyXblGetEntityIdsFromXboxLiveUserIdsCompletedStateChange 表示失敗,且結果為 PartyXblStateChangeResult::PlayFabUserNotAuthorized,則在成功呼叫 LoginToPlayFab() 之後,最多可以重試作業一次。

如果與此呼叫完成相關聯的 PartyXblGetEntityIdsFromXboxLiveUserIdsCompletedStateChange 表示失敗,且結果為 PartyXblStateChangeResult::PlayFabRateLimitExceeded,則可以在短暫延遲後重試作業。

需求

標頭: PartyXboxLive.h

另請參閱

PartyXblManager
PartyXblGetEntityIdsFromXboxLiveUserIdsCompletedStateChange
最後修改於 2026年10月8日