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

# Mostrar personas del sistema de contactos

> Patrones de llamada para mostrar los datos de la lista de contactos de XBOX Live combinando los servicios People, Presence, Profile y Leaderboards con el moniker People.

<a id="top" />

Este tema describe el flujo de código para mostrar personas mediante el sistema de contactos. A continuación se muestran algunos escenarios de ejemplo de flujo de llamadas que muestran cómo los títulos obtienen datos de los servicios relacionados con People.

* [Lista de usuarios actualmente en el juego](#loucig)
* [Lista de los contactos del usuario actual que están en línea](#lotcupwao)
* [Tabla de clasificación global que contiene usuarios aleatorios](#glcru)
* [Tabla de clasificación de los contactos del usuario](#loup)

Los servicios de XBOX Live devuelven solo los datos que pertenecen a ese servicio y devuelven únicamente referencias XUID a los usuarios.
Estos son algunos ejemplos.

* El *servicio People* solo posee y devuelve los XUID que están en la lista de contactos de un usuario y cierta información muy básica sobre cada uno de esos XUID (como el estado de favorito).
* El *servicio Presence* posee los datos sobre la información de estado en línea de los XUID.
* El *servicio Leaderboards* posee la información de clasificación de listas de XUID.

Para representar listas de personas en las experiencias, debe llamar a varios servicios. Esto se debe a que la información del nombre para mostrar y del gamertag nunca se devuelve desde un servicio distinto del *servicio Profile*.

El patrón de llamada general para las API de servicio consiste en realizar un viaje de ida y vuelta para obtener primero una lista de XUID del servicio que mejor pueda filtrar u ordenar la lista y, después, realizar llamadas de ida y vuelta simultáneas a otros servicios según sea necesario para obtener los metadatos adicionales requeridos para cada XUID.
Para las imágenes, puede ser necesario un tercer viaje de ida y vuelta de llamadas para obtener las imágenes desde las direcciones URL de las imágenes.

Para reducir el número de viajes de ida y vuelta necesarios para obtener datos sobre la lista de contactos de un usuario, se ha introducido un *moniker* People en los servicios pertinentes.
Esta característica permite a los autores de las llamadas expresar de forma abstracta al servicio principal que debe obtener la lista de contactos del usuario del servicio People y, después, usar ese conjunto de XUID para acotar el resultado devuelto.

[Volver al principio de este tema.](#top)

<a id="loucig" />

## Lista de usuarios actualmente en el juego

**El título tiene:**

Lista de XUID aleatorios de otros usuarios en el juego.

**Objetivo:**

Representar información mínima de cada uno de los demás usuarios.

**Campo que se va a representar \[servicio propietario]:**

`GameDisplayName` \[Profile]

**Flujo de llamadas:**

Llame a `Profile` con la lista de XUID.

[Volver al principio de este tema.](#top)

<a id="lotcupwao" />

## Lista de los contactos del usuario actual que están en línea

**El título tiene:**

El XUID del usuario actual.

**Objetivo:**

Representar una lista enriquecida de los usuarios en línea que están en la lista de contactos del usuario actual.

**Campo que se va a representar \[servicio propietario]:**

* Indicador de favorito \[People]
* Imagen para mostrar \[Profile]
* `GameDisplayName` \[Profile]
* Estado en línea básico (círculo verde) \[Presence]

**Flujo de llamadas:**

1. Llame a `Presence` pasando el moniker `People` para obtener los XUID y el estado en línea de cada uno de los contactos del usuario.
2. En paralelo:
   1. Llame a `Profile` pasando la lista completa de XUID para obtener el nombre para mostrar y la dirección URL de la imagen de cada uno. Después, obtenga las imágenes de cada dirección URL de imagen.
   2. Llame a `People` pasando la lista de XUID para averiguar si alguno es favorito del usuario.

[Volver al principio de este tema.](#top)

<a id="glcru" />

## Tabla de clasificación global que contiene usuarios aleatorios

**El título tiene:**

El identificador o nombre de la tabla de clasificación.

**Objetivo:**

Representar información básica de cada usuario de la tabla de clasificación.

**Campo que se va a representar \[servicio propietario]:**

* Indicador de favorito \[People]
* `GameDisplayName` \[Profile]
* Posición \[Leaderboards]
* Puntuación \[Leaderboards]

**Flujo de llamadas:**

1. Llame a `Leaderboards` para obtener los XUID, la posición y las puntuaciones de la tabla de clasificación concreta.
2. En paralelo:
   * Llame a `Profile` pasando la lista de XUID para obtener el nombre para mostrar y la dirección URL de la imagen de cada uno.
   * Llame a `People` pasando la lista de XUID para averiguar si alguno es favorito del usuario.

[Volver al principio de este tema.](#top)

<a id="loup" />

## Tabla de clasificación de los contactos del usuario

**El título tiene:**

* El identificador o nombre de la tabla de clasificación
* El XUID del usuario actual

**Objetivo:**

Representar información básica de cada usuario de la tabla de clasificación.

**Campo que se va a representar \[servicio propietario]:**

* Indicador de favorito \[People]
* `GameDisplayName` \[Profile]
* Posición \[Leaderboards]
* Puntuación \[Leaderboards]

**Flujo de llamadas:**

1. Llame a `Leaderboards` pasando el moniker `People` para obtener los XUID, la posición y las puntuaciones de la tabla de clasificación concreta limitada a la lista de contactos del usuario.
2. En paralelo:
   * Llame a `Profile` pasando la lista de XUID para obtener el nombre para mostrar y la dirección URL de la imagen de cada uno.
   * Llame a `People` pasando la lista de XUID para averiguar si alguno es favorito del usuario.

[Volver al principio de este tema.](#top)


## Related topics

- [Conceptos del sistema de contactos (lista de amigos)](/es/services/xbox-services/community/people-system/concepts/live-people-system-concepts-nav.md)
- [Conceptos](/es/services/xbox-services/community/people-system/concepts/index.md)
- [Información general del sistema de contactos (lista de amigos)](/es/services/xbox-services/community/people-system/live-people-system-overview.md)
- [Código de ejemplo del sistema de contactos (lista de amigos)](/es/services/xbox-services/community/people-system/how-to/live-pplsys-howto-nav.md)
- [Sistema de contactos (lista de amigos)](/es/services/xbox-services/community/people-system/live-people-system-nav.md)
