Visualización de personas del sistema de personas

A continuación se muestran algunos escenarios de flujo de llamadas de ejemplo que muestran cómo los títulos obtienen datos de servicios relacionados con las personas:

Los servicios de Xbox Live devuelven solo los datos que son propiedad de ese servicio y solo devuelven referencias XUID a los usuarios. Por ejemplo:

  • El servicio de contactos solo posee y devuelve los XUIDs que se encuentran en la lista de personas de un usuario y una información muy básica sobre cada uno de esos XUIDs (como el estado de favoritos).
  • El servicio de presencia posee datos sobre la información de estado de conexión de XUIDs.
  • El servicio de marcadores posee información sobre la clasificación de las listas de XUIDs.

Para representar listas de personas en experiencias, debe llamar a varios servicios, ya que la información de nombre para mostrar y nombre de jugador nunca se devuelve desde cualquier servicio que no sea el servicio de perfil.

El patrón de llamadas general para las API de servicio es realizar una acción de ida y vuelta para obtener primero una lista de XUIDs del servicio que mejor filtra u ordena la lista y, a continuación, hacer llamadas simultáneas de ida y vuelta a otros servicios necesarios para obtener metadatos adicionales. necesario para cada XIUD. En el caso de las imágenes, es posible que se necesite un tercer recorrido de ida y vuelta de llamadas para obtener imágenes de 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 está introduciendo un moniker de personas para los servicios relevantes. Esta característica permite a los autores de las llamadas expresar de forma abstracta el servicio principal en el que el servicio debe obtener la lista de personas del servicio de personas y, a continuación, usar ese conjunto de XUIDs para definir el valor devuelto.

Lista de usuarios que se encuentran actualmente en el juego

El título tiene:

Lista de XUIDs aleatorios de otros usuarios en el juego

Conseguir

Para representar la información mínima de cada uno de los demás usuarios

Campo para representar [servicio propietario]:

GameDisplayName \ [perfil ]

Flujo de llamadas:

Perfil de llamada con la lista de XUIDs.

Lista de las personas del usuario actual que están conectadas

El título tiene:

El XUID del usuario actual.

Conseguir

Para representar una lista de usuarios en línea en la lista de personas del usuario actual.

Campo para representar [servicio propietario]:

  • Indicador favorito [personas]
  • Imagen para mostrar [perfil]
  • GameDisplayName [perfil]
  • Estado de conexión básico (bola verde) [presencia]

Flujo de llamadas:

  1. Llama a la presencia y pasa el moniker personas para obtener el XUIDs y el estado de conexión de cada uno de los usuarios.
  2. En paralelo:
    1. Llama a perfil y pasa toda la lista de XUIDs para obtener el nombre para mostrar y la dirección URL de la imagen para cada uno. A continuación, Obtén imágenes para cada dirección URL de la imagen.
    2. Llama a personas y pasa la lista de XUIDs para averiguar si alguno es un favorito del usuario.

Un poseedor global que contiene usuarios aleatorios

El título tiene:

Identificador/nombre del identificador de la clasificación.

Conseguir

Para representar la información básica de cada usuario en el preparador.

Campo para representar [servicio propietario]:

  • Indicador favorito [personas]
  • GameDisplayName [perfil]
  • Clasificar [marcadores]
  • Puntuación [marcadores]

Flujo de llamadas:

  1. Llama a los marcadores de la llamada para obtener la XUIDs, el rango y las puntuaciones de un determinado puesto.
  2. En paralelo:
    • Perfil de llamada, que pasa la lista de XUIDs para obtener el nombre para mostrar y la dirección URL de la imagen para cada uno.
    • Llama a personas y pasa la lista de XUIDs para averiguar si alguno es un favorito del usuario.

Marcadores de la gente del usuario

El título tiene:

  • Identificador/nombre del identificador de la clasificación
  • La XUID del usuario actual

Conseguir

Para representar la información básica de cada usuario en el preparador.

Campo para representar [servicio propietario]:

  • Indicador favorito [personas]
  • GameDisplayName [perfil]
  • Clasificar [marcadores]
  • Puntuación [marcadores]

Flujo de llamadas:

  1. Llama a los marcadores de la llamada y pasa el moniker personas para obtener la XUIDs, el rango y las puntuaciones de un determinado puesto limitado a la lista de contactos del usuario.
  2. En paralelo:
    • Perfil de llamada, que pasa la lista de XUIDs para obtener el nombre para mostrar y la dirección URL de la imagen para cada uno.
    • Llama a personas y pasa la lista de XUIDs para averiguar si alguno es un favorito del usuario.