> ## 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.
# Affichage des personnes du système de personnes
> Modèles d'appel pour afficher les données de la liste de personnes XBOX Live en combinant les services People, Presence, Profile et Leaderboards avec le moniker People.
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.
* [Liste des utilisateurs actuellement dans le jeu](#loucig)
* [Liste des personnes de l'utilisateur actuel qui sont en ligne](#lotcupwao)
* [Classement global contenant des utilisateurs aléatoires](#glcru)
* [Classement des personnes de l'utilisateur](#loup)
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.](#top)
## 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.](#top)
## 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.](#top)
## 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.](#top)
## 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.](#top)
## Related topics
- [Concepts du système de personnes (liste d'amis)](/fr/services/xbox-services/community/people-system/concepts/live-people-system-concepts-nav.md)
- [Concepts](/fr/services/xbox-services/community/people-system/concepts/index.md)
- [Système de personnes](/fr/services/xbox-services/community/people-system/index.md)
- [Vue d'ensemble du système de personnes (liste d'amis)](/fr/services/xbox-services/community/people-system/live-people-system-overview.md)
- [Système de personnes (liste d'amis)](/fr/services/xbox-services/community/people-system/live-people-system-nav.md)