Mostrar personas del sistema de contactos

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
• Lista de los contactos del usuario actual que están en línea
• Tabla de clasificación global que contiene usuarios aleatorios
• Tabla de clasificación de los contactos del usuario

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.

​

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.

​

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.

​

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.

​

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.