Skip to main content
将异步操作加入队列,以检索 PlayFab 实体 ID 与已知 XBOX Live 用户 ID 之间的映射列表。

Syntax

Parameters

xboxLiveUserIdCount   uint32_t xboxLiveUserIds 数组中 XBOX Live 用户 ID 的数量。 xboxLiveUserIds   uint64_t*
input array of size xboxLiveUserIdCount
大小为 xboxLiveUserIdCount 的数组,包含库将用于查询 PlayFab 实体 ID 的 XBOX Live 用户 ID。 localChatUser   PartyXblLocalChatUser* 将用于与 PlayFab 通信的本地聊天用户。如有需要,将使该本地聊天用户登录到 PlayFab。 asyncIdentifier   void*
optional
可选的应用定义的、指针大小的上下文值,可用于将完成状态更改与此调用关联。

Return value

PartyError 如果操作已启动则返回 c_partyErrorSuccess,否则返回错误代码。错误代码的可读形式可通过 GetErrorMessage() 获取。

Remarks

只有当 XBOX Live 用户已与 PlayFab 账户关联时,每个 XBOX Live 用户 ID 才会映射到 PlayFab 实体 ID。首次调用 PartyXblManager::LoginToPlayFab 时会自动创建并关联 PlayFab 账户。也可以使用 PlayFab SDK 提供的 LoginWithXbox API 来关联账户。

如果与此调用完成相关联的 PartyXblGetEntityIdsFromXboxLiveUserIdsCompletedStateChange 指示失败,结果为 PartyXblStateChangeResult::PlayFabUserNotAuthorized,则在成功调用 LoginToPlayFab() 后最多可重试一次。

如果与此调用完成相关联的 PartyXblGetEntityIdsFromXboxLiveUserIdsCompletedStateChange 指示失败,结果为 PartyXblStateChangeResult::PlayFabRateLimitExceeded,则可以在短暂延迟后重试该操作。

Requirements

Header: PartyXboxLive.h

See also

PartyXblManager
PartyXblGetEntityIdsFromXboxLiveUserIdsCompletedStateChange
最后修改于 2026年8月25日