> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 从人员系统显示人员

> 通过将 People、Presence、Profile 和 Leaderboards 服务与 People moniker 结合使用来显示 XBOX Live 人员列表数据的调用模式。

<a id="top" />

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

* [当前在游戏中的用户列表](#loucig)
* [当前用户人员中当前在线者的列表](#lotcupwao)
* [包含随机用户的全球排行榜](#glcru)
* [用户人员的排行榜](#loup)

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

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

要在体验中呈现人员列表，您必须调用多个服务。这是因为除*Profile 服务*外，任何其他服务都不会返回显示名称和 gamertag 信息。

服务 API 的一般调用模式是首先向最能过滤或排序列表的服务进行一次往返以获取 XUID 列表，然后根据需要向其他服务同时进行往返调用，以获取每个 XUID 所需的任何其他元数据。
对于图像，可能还需要第三次往返调用以从图像 URL 获取图像。

为了减少获取用户人员列表数据所需的往返次数，相关服务中引入了 People *moniker*。
此功能允许调用者以抽象方式向主要服务表达它应该从人员服务获取用户的人员列表，然后使用该 XUID 集来限定返回范围。

[返回本主题顶部。](#top)

<a id="loucig" />

## 当前在游戏中的用户列表

**Title 有：**

游戏中其他用户的随机 XUID 列表。

**目标：**

为每位其他用户呈现最少的信息。

**要呈现的字段 \[所属服务]：**

`GameDisplayName` \[Profile]

**调用流程：**

使用 XUID 列表调用 `Profile`。

[返回本主题顶部。](#top)

<a id="lotcupwao" />

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

**Title 有：**

当前用户的 XUID。

**目标：**

呈现当前用户人员列表中在线用户的丰富列表。

**要呈现的字段 \[所属服务]：**

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

**调用流程：**

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

[返回本主题顶部。](#top)

<a id="glcru" />

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

**Title 有：**

排行榜的 ID/名称。

**目标：**

为排行榜上的每位用户呈现基本信息。

**要呈现的字段 \[所属服务]：**

* 收藏指示器 \[People]
* `GameDisplayName` \[Profile]
* 排名 \[Leaderboards]
* 得分 \[Leaderboards]

**调用流程：**

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

[返回本主题顶部。](#top)

<a id="loup" />

## 用户人员的排行榜

**Title 有：**

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

**目标：**

为排行榜上的每位用户呈现基本信息。

**要呈现的字段 \[所属服务]：**

* 收藏指示器 \[People]
* `GameDisplayName` \[Profile]
* 排名 \[Leaderboards]
* 得分 \[Leaderboards]

**调用流程：**

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

[返回本主题顶部。](#top)


## Related topics

- [人员系统（好友列表）概念](/zh-CN/services/xbox-services/community/people-system/concepts/live-people-system-concepts-nav.md)
- [XR-070 好友列表](/zh-CN/publishing/certification/xr/xr-070.md)
- [社交功能概述](/zh-CN/services/xbox-services/community/live-social-overview.md)
- [使用 GDK 工具安装并启动 PC 游戏](/zh-CN/tools/tools-pc/launching-on-pc.md)
- [XBOX services 概述](/zh-CN/services/xbox-services/fundamentals/live-xbl-overview.md)