从人员系统显示人员

本主题介绍使用人员系统显示人员的代码流程。以下是一些示例调用流程场景，展示了 title 如何从与人员相关的服务中获取数据。

• 当前在游戏中的用户列表
• 当前用户人员中当前在线者的列表
• 包含随机用户的全球排行榜
• 用户人员的排行榜

XBOX Live 中的服务仅返回由该服务拥有的数据，并且只返回对用户的 XUID 引用。 以下是一些示例。

• 人员服务仅拥有并返回用户人员列表中的 XUID 以及每个 XUID 的一些非常基本的信息（例如收藏状态）。
• 状态服务拥有关于 XUID 在线状态信息的数据。
• 排行榜服务拥有 XUID 列表的排名信息。

要在体验中呈现人员列表，您必须调用多个服务。这是因为除Profile 服务外，任何其他服务都不会返回显示名称和 gamertag 信息。 服务 API 的一般调用模式是首先向最能过滤或排序列表的服务进行一次往返以获取 XUID 列表，然后根据需要向其他服务同时进行往返调用，以获取每个 XUID 所需的任何其他元数据。 对于图像，可能还需要第三次往返调用以从图像 URL 获取图像。 为了减少获取用户人员列表数据所需的往返次数，相关服务中引入了 People moniker。 此功能允许调用者以抽象方式向主要服务表达它应该从人员服务获取用户的人员列表，然后使用该 XUID 集来限定返回范围。 返回本主题顶部。

​

当前在游戏中的用户列表

Title 有： 游戏中其他用户的随机 XUID 列表。 目标： 为每位其他用户呈现最少的信息。 要呈现的字段 [所属服务]： GameDisplayName [Profile] 调用流程： 使用 XUID 列表调用 Profile。 返回本主题顶部。

​

当前用户人员中当前在线者的列表

Title 有： 当前用户的 XUID。 目标： 呈现当前用户人员列表中在线用户的丰富列表。 要呈现的字段 [所属服务]：

• 收藏指示器 [People]
• 显示图片 [Profile]
• GameDisplayName [Profile]
• 基本在线状态（绿色圆圈）[Presence]

调用流程：

1. 调用 Presence，传入 People moniker 以获取用户人员中每个人的 XUID 和在线状态。
2. 并行地：
   1. 调用 Profile，传入整个 XUID 列表以获取每个 XUID 的显示名称和图片 URL。然后，为每个图片 URL 获取图像。
   2. 调用 People，传入 XUID 列表以查明其中任何人是否是用户的收藏。

返回本主题顶部。

​

包含随机用户的全球排行榜

Title 有： 排行榜的 ID/名称。 目标： 为排行榜上的每位用户呈现基本信息。 要呈现的字段 [所属服务]：

• 收藏指示器 [People]
• GameDisplayName [Profile]
• 排名 [Leaderboards]
• 得分 [Leaderboards]

调用流程：

1. 调用 Leaderboards 以获取特定排行榜的 XUID、排名和得分。
2. 并行地：
   • 调用 Profile，传入 XUID 列表以获取每个 XUID 的显示名称和图片 URL。
   • 调用 People，传入 XUID 列表以查明其中任何人是否是用户的收藏。

返回本主题顶部。

​

用户人员的排行榜

Title 有：

• 排行榜的 ID/名称
• 当前用户的 XUID

目标： 为排行榜上的每位用户呈现基本信息。 要呈现的字段 [所属服务]：

• 收藏指示器 [People]
• GameDisplayName [Profile]
• 排名 [Leaderboards]
• 得分 [Leaderboards]

调用流程：

1. 调用 Leaderboards，传入 People moniker 以获取特定排行榜的 XUID、排名和得分，该排行榜仅限于用户的人员列表。
2. 并行地：
   • 调用 Profile，传入 XUID 列表以获取每个 XUID 的显示名称和图片 URL。
   • 调用 People，传入 XUID 列表以查明其中任何人是否是用户的收藏。

返回本主题顶部。