Passer au contenu principal
Cette rubrique décrit le flux de code permettant d’afficher des personnes à l’aide du système de personnes. Voici quelques exemples de scénarios de flux d’appels qui montrent comment les titres obtiennent des données auprès des services liés aux personnes. Les services de XBOX Live ne renvoient que les données qui leur appartiennent et ne renvoient que des références XUID aux utilisateurs. Voici quelques exemples.
  • Le service People possède et renvoie uniquement les XUID figurant dans la liste de personnes d’un utilisateur, ainsi que quelques informations très élémentaires sur chacun de ces XUID (comme le statut de favori).
  • Le service Presence possède les données relatives à l’état en ligne des XUID.
  • Le service Leaderboards possède les informations de classement des listes de XUID.
Pour afficher des listes de personnes dans des expériences, vous devez appeler plusieurs services. En effet, les informations de nom d’affichage et de gamertag ne sont jamais renvoyées par un autre service que le service Profile. Le modèle d’appel général des API de service consiste à effectuer un premier aller-retour pour obtenir une liste de XUID auprès du service le mieux à même de filtrer ou de trier la liste, puis à effectuer des appels aller-retour simultanés vers d’autres services, selon les besoins, pour obtenir les métadonnées supplémentaires requises pour chaque XUID. Pour les images, un troisième aller-retour d’appels peut être nécessaire afin d’obtenir les images à partir de leurs URL. Pour réduire le nombre d’allers-retours nécessaires à l’obtention des données relatives à la liste de personnes d’un utilisateur, un moniker People a été introduit dans les services concernés. Cette fonctionnalité permet aux appelants d’indiquer de manière abstraite au service principal qu’il doit obtenir la liste des personnes de l’utilisateur auprès du service People, puis utiliser cet ensemble de XUID pour délimiter les résultats renvoyés. Retour en haut de cette rubrique.

​
Liste des utilisateurs actuellement dans le jeu

Le titre dispose de : Une liste de XUID aléatoires d’autres utilisateurs présents dans le jeu. Objectif : Afficher un minimum d’informations pour chacun des autres utilisateurs. Champ à afficher [service propriétaire] : GameDisplayName [Profile] Flux d’appels : Appelez Profile avec la liste des XUID. Retour en haut de cette rubrique.

​
Liste des personnes de l’utilisateur actuel qui sont en ligne

Le titre dispose de : Le XUID de l’utilisateur actuel. Objectif : Afficher une liste enrichie des utilisateurs en ligne qui figurent dans la liste de personnes de l’utilisateur actuel. Champ à afficher [service propriétaire] :
  • Indicateur de favori [People]
  • Image d’affichage [Profile]
  • GameDisplayName [Profile]
  • État en ligne de base (cercle vert) [Presence]
Flux d’appels :
  1. Appelez Presence en transmettant le moniker People pour obtenir les XUID et l’état en ligne de chacune des personnes de l’utilisateur.
  2. En parallèle :
    1. Appelez Profile en transmettant la liste complète des XUID pour obtenir le nom d’affichage et l’URL de l’image de chacun. Obtenez ensuite les images à partir de chaque URL.
    2. Appelez People en transmettant la liste des XUID pour savoir si certains d’entre eux sont des favoris de l’utilisateur.
Retour en haut de cette rubrique.

​
Classement global contenant des utilisateurs aléatoires

Le titre dispose de : L’ID ou le nom du classement. Objectif : Afficher les informations de base de chaque utilisateur du classement. Champ à afficher [service propriétaire] :
  • Indicateur de favori [People]
  • GameDisplayName [Profile]
  • Rang [Leaderboards]
  • Score [Leaderboards]
Flux d’appels :
  1. Appelez Leaderboards pour obtenir les XUID, le rang et les scores du classement concerné.
  2. En parallèle :
    • Appelez Profile en transmettant la liste des XUID pour obtenir le nom d’affichage et l’URL de l’image de chacun.
    • Appelez People en transmettant la liste des XUID pour savoir si certains d’entre eux sont des favoris de l’utilisateur.
Retour en haut de cette rubrique.

​
Classement des personnes de l’utilisateur

Le titre dispose de :
  • L’ID ou le nom du classement
  • Le XUID de l’utilisateur actuel
Objectif : Afficher les informations de base de chaque utilisateur du classement. Champ à afficher [service propriétaire] :
  • Indicateur de favori [People]
  • GameDisplayName [Profile]
  • Rang [Leaderboards]
  • Score [Leaderboards]
Flux d’appels :
  1. Appelez Leaderboards en transmettant le moniker People pour obtenir les XUID, le rang et les scores du classement concerné, limité à la liste de personnes de l’utilisateur.
  2. En parallèle :
    • Appelez Profile en transmettant la liste des XUID pour obtenir le nom d’affichage et l’URL de l’image de chacun.
    • Appelez People en transmettant la liste des XUID pour savoir si certains d’entre eux sont des favoris de l’utilisateur.
Retour en haut de cette rubrique.
Dernière modification le 8 octobre 2026