Passer au contenu principal
Avec PlayFab, vous construisez généralement les classements à l’aide des méthodes d’API suivantes : Le résultat est une liste d’objets PlayerLeaderboardEntry qui ne contiennent que des informations de base sur le joueur et sa position dans le classement actuel. Cependant, PlayFab vous permet également d’utiliser PlayerProfileViewConstraints pour obtenir des informations supplémentaires sur chaque joueur.
Cet exemple suppose que vous disposez déjà de données de classement à exploiter. Consultez notre tutoriel Accéder aux résultats archivés des tournois pour une méthode de génération de données de test.

Configuration des contraintes d’affichage du profil de joueur

Par défaut, l’API client ne peut récupérer que le nom d’affichage à partir du profil d’un autre joueur. Dans cet exemple, nous allons permettre à tous les joueurs d’accéder à des informations supplémentaires sur les autres joueurs du classement. Accédez au Game Manager de votre titre :
  1. Sélectionnez l’icône Settings dans le menu de gauche.
  2. Sélectionnez Title settings
  3. Sélectionnez ensuite l’onglet Client Profile Options.
  4. Vérifiez que DisplayName est sélectionné.
  5. Assurez-vous que Avatar URL est sélectionné.
  6. Validez vos modifications en sélectionnant le bouton Save Client Profile Options.
Game Manager - Paramètres - Options du profil client

Test

L’étape précédente permet au code client d’utiliser les contraintes de profil DisplayName et AvatarUrl. L’exemple suivant montre comment récupérer et afficher un classement en utilisant les données de profil mentionnées. Consultez les commentaires du code pour plus d’informations.
Les champs de profil individuels ne sont disponibles que si le client les demande explicitement à l’aide des contraintes de profil. Sachez également que si certaines contraintes de profil ne sont pas autorisées dans Game Manager et que votre client les demande, l’appel d’API échouera avec l’erreur correspondante. Le résultat ressemblera à l’exemple ci-dessous.
Sortie - Afficher le classement Grâce à cette technique, vous pouvez récupérer un certain nombre d’informations de profil, y compris d’autres valeurs de statistiques.
Dernière modification le 6 octobre 2026