> ## 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.

# Exibindo pessoas do sistema de pessoas

> Padrões de chamada para exibir dados da lista de pessoas do XBOX Live combinando os serviços People, Presence, Profile e Leaderboards com o moniker People.

<a id="top" />

Este tópico descreve o fluxo de código para exibir pessoas usando o sistema de pessoas. Aqui estão alguns exemplos de cenários de fluxo de chamadas que mostram como os títulos obtêm dados dos serviços relacionados a pessoas.

* [Lista de usuários que estão no jogo no momento](#loucig)
* [Lista das pessoas do usuário atual que estão online](#lotcupwao)
* [Placar global que contém usuários aleatórios](#glcru)
* [Placar das pessoas do usuário](#loup)

Os serviços do XBOX Live retornam apenas os dados de propriedade daquele serviço e retornam somente referências de XUID para os usuários.
Aqui estão alguns exemplos.

* O *serviço People* possui e retorna apenas os XUIDs que estão na lista de pessoas de um usuário e algumas informações muito básicas sobre cada um desses XUIDs (como o status de favorito).
* O *serviço Presence* possui os dados sobre as informações de status online dos XUIDs.
* O *serviço Leaderboards* possui as informações de classificação das listas de XUIDs.

Para renderizar listas de pessoas nas experiências, você precisa chamar vários serviços. Isso ocorre porque as informações de nome de exibição e gamertag nunca são retornadas por nenhum serviço que não seja o *serviço Profile*.

O padrão geral de chamada das APIs de serviço é fazer uma viagem de ida e volta para primeiro obter uma lista de XUIDs do serviço que melhor consegue filtrar ou classificar a lista e, em seguida, fazer chamadas simultâneas de ida e volta para outros serviços, conforme necessário, para obter quaisquer metadados adicionais necessários para cada XUID.
Para imagens, pode ser necessária uma terceira rodada de chamadas para obter as imagens a partir das URLs de imagem.

Para reduzir o número de viagens de ida e volta necessárias para obter dados sobre a lista de pessoas de um usuário, um *moniker* People foi introduzido nos serviços relevantes.
Esse recurso permite que os chamadores indiquem de forma abstrata ao serviço principal que ele deve obter a lista de pessoas do usuário no serviço People e, em seguida, usar esse conjunto de XUIDs para delimitar o retorno.

[Voltar ao início deste tópico.](#top)

<a id="loucig" />

## Lista de usuários que estão no jogo no momento

**O título tem:**

Uma lista de XUIDs aleatórios de outros usuários no jogo.

**Objetivo:**

Renderizar informações mínimas para cada um dos outros usuários.

**Campo a renderizar \[serviço proprietário]:**

`GameDisplayName` \[Profile]

**Fluxo de chamadas:**

Chame `Profile` com a lista de XUIDs.

[Voltar ao início deste tópico.](#top)

<a id="lotcupwao" />

## Lista das pessoas do usuário atual que estão online

**O título tem:**

O XUID do usuário atual.

**Objetivo:**

Renderizar uma lista detalhada dos usuários online que estão na lista de pessoas do usuário atual.

**Campo a renderizar \[serviço proprietário]:**

* Indicador de favorito \[People]
* Imagem de exibição \[Profile]
* `GameDisplayName` \[Profile]
* Status online básico (círculo verde) \[Presence]

**Fluxo de chamadas:**

1. Chame `Presence`, passando o moniker `People` para obter os XUIDs e o status online de cada uma das pessoas do usuário.
2. Em paralelo:
   1. Chame `Profile`, passando a lista inteira de XUIDs para obter o nome de exibição e a URL da imagem de cada um. Em seguida, obtenha as imagens de cada URL de imagem.
   2. Chame `People`, passando a lista de XUIDs para descobrir se algum deles é favorito do usuário.

[Voltar ao início deste tópico.](#top)

<a id="glcru" />

## Placar global que contém usuários aleatórios

**O título tem:**

O ID/nome do placar.

**Objetivo:**

Renderizar informações básicas de cada usuário no placar.

**Campo a renderizar \[serviço proprietário]:**

* Indicador de favorito \[People]
* `GameDisplayName` \[Profile]
* Classificação \[Leaderboards]
* Pontuação \[Leaderboards]

**Fluxo de chamadas:**

1. Chame `Leaderboards` para obter os XUIDs, a classificação e as pontuações do placar específico.
2. Em paralelo:
   * Chame `Profile`, passando a lista de XUIDs para obter o nome de exibição e a URL da imagem de cada um.
   * Chame `People`, passando a lista de XUIDs para descobrir se algum deles é favorito do usuário.

[Voltar ao início deste tópico.](#top)

<a id="loup" />

## Placar das pessoas do usuário

**O título tem:**

* O ID/nome do placar
* O XUID do usuário atual

**Objetivo:**

Renderizar informações básicas de cada usuário no placar.

**Campo a renderizar \[serviço proprietário]:**

* Indicador de favorito \[People]
* `GameDisplayName` \[Profile]
* Classificação \[Leaderboards]
* Pontuação \[Leaderboards]

**Fluxo de chamadas:**

1. Chame `Leaderboards`, passando o moniker `People` para obter os XUIDs, a classificação e as pontuações do placar específico, limitado à lista de pessoas do usuário.
2. Em paralelo:
   * Chame `Profile`, passando a lista de XUIDs para obter o nome de exibição e a URL da imagem de cada um.
   * Chame `People`, passando a lista de XUIDs para descobrir se algum deles é favorito do usuário.

[Voltar ao início deste tópico.](#top)


## Related topics

- [Conceitos do sistema de pessoas (lista de amigos)](/pt-BR/services/xbox-services/community/people-system/concepts/live-people-system-concepts-nav.md)
- [Conceitos](/pt-BR/services/xbox-services/community/people-system/concepts/index.md)
- [Sistema de pessoas](/pt-BR/services/xbox-services/community/people-system/index.md)
- [Sistema de pessoas (lista de amigos)](/pt-BR/services/xbox-services/community/people-system/live-people-system-nav.md)
- [Visão geral do sistema de pessoas (lista de amigos)](/pt-BR/services/xbox-services/community/people-system/live-people-system-overview.md)