Vue d'ensemble des classements basés sur les événements

Cette rubrique décrit comment les classements comparent les joueurs en affichant certaines statistiques d’un jeu. Les classements constituent un moyen ludique d’impliquer les joueurs et de stimuler la compétition entre eux. Les services XBOX fournissent des fonctionnalités adaptées à vos joueurs les plus assidus (classement global par rapport à l’ensemble de la population XBOX) et à vos joueurs occasionnels (classement social par rapport aux amis d’un joueur). Deux types de classements sont à votre disposition : global et social. Ils reposent sur des concepts très similaires, mais présentent des différences fondamentales en termes de configuration et d’objectif.

​

Classements globaux et classements sociaux

​

Classements globaux

• Un classement global classe l’ensemble de la base d’utilisateurs XBOX et doit être configuré.
• Un classement global est une vue prédéfinie que vous configurez dans le service au moment de l’ingestion (avant la sortie du titre ou à tout moment après).

​

Classements sociaux

• Un classement social est généré dynamiquement et classe les amis du joueur.
• Un classement social n’inclut que les joueurs qui figurent dans le graphe social du joueur.
• Un classement social n’a pas besoin d’être prédéfini au moment de l’ingestion, car le service le génère dynamiquement à l’exécution, en fonction des statistiques utilisateur existantes.

​

Comprendre les classements

Les classements comportent deux composants principaux.

• Une valeur servant de base au classement (dans les services XBOX, il s’agit toujours d’une instance de statistique de joueur).
• L’ordre de tri (les valeurs les plus élevées ou les plus faibles sont les meilleures).

​

Statistiques comme valeurs de classement

Les classements sont dérivés des statistiques de joueur. Il est essentiel de définir les règles de statistiques adaptées à vos besoins. Lors de la conception de votre jeu, gardez à l’esprit les classements dans lesquels vous souhaitez que vos joueurs soient classés.

​

Classements globaux

Les classements globaux suivent les meilleurs scores enregistrés par les joueurs de toute la communauté XBOX. La principale particularité des classements globaux est qu’ils sont prédéfinis au moment de l’ingestion, en spécifiant un nom d’identification du classement, la statistique classée et l’ordre de tri (croissant ou décroissant). Les titres peuvent définir un nombre illimité de classements globaux et en ajouter à tout moment via la configuration de service. Le nombre maximal d’enregistrements par classement global est actuellement limité à 10 000 entrées. Cela signifie que les joueurs dont le « meilleur » score ne figure pas dans les 10 000 premiers n’apparaissent pas dans le classement. Il est possible de lire une « page » de 100 entrées de classement au maximum à la fois (XUID du joueur, gamertag, rang global et score) en spécifiant le rang de départ de la page, ou de récupérer des entrées de classement centrées autour d’un gamertag spécifié. Les résultats portent toujours sur l’ensemble de la période ; les vues par jour, par semaine et par mois ne sont pas encore prises en charge. Les classements globaux sont accessibles via l’API des services XBOX (XSAPI) ou via notre API REST à l’aide de GET (/scids/{scid}/leaderboards/{leaderboardname}). Voici une capture d’écran montrant comment un exemple de classement pourrait être configuré pour un jeu de course.

​

Classements sociaux

Les classements sociaux constituent d’excellentes motivations pour les joueurs occasionnels, qui peuvent se comparer et se classer par rapport à leurs amis. Même s’ils ne figurent pas parmi les meilleurs de la communauté, ils peuvent rester motivés pour battre des joueurs qu’ils connaissent. Les classements sociaux sont créés dynamiquement à partir de n’importe quelle statistique utilisateur existante. Ils n’ont donc pas besoin d’être prédéfinis au moment de l’ingestion et ne contiennent que les joueurs du graphe social d’un joueur donné. Le principal avantage des classements sociaux est qu’ils ne sont pas prédéfinis. Vous pouvez créer un classement social pour n’importe quelle statistique de votre jeu. L’appelant peut spécifier deux éléments lorsqu’il demande un classement social : l’instance de statistique et l’ordre de tri (par défaut, décroissant selon la note). Les résultats portent toujours sur l’ensemble de la période ; les vues par jour, par semaine et par mois ne sont pas prises en charge. Comme pour les classements globaux, un appelant peut lire une « page » de 100 entrées de classement au maximum à la fois (XUID du joueur, gamertag, rang global et score) en spécifiant le rang de départ de la page. Les classements sociaux sont accessibles via XSAPI ou via notre API REST à l’aide de GET (/users/xuid({xuid})/scids/{scid}/stats/{statname)/people/{all|favorite}).

​

Classements globaux avec une vue sociale

Comme les classements sociaux sont créés dynamiquement, leur récupération prend plus de temps que celle d’un classement global. Dans les scénarios où votre titre récupère fréquemment un classement social selon un ensemble de critères communs, vous pouvez créer un classement global et ne récupérer que les entrées du classement qui concernent le graphe social du joueur. Cela permet une récupération plus rapide qu’avec les classements sociaux, car le classement existe déjà sur les serveurs des services XBOX. La charge utile est également plus petite, car les résultats sont limités au graphe social de l’utilisateur. Ce type de classement est un classement global. Il doit donc être défini dans la configuration de service du titre. Les classements globaux avec une vue sociale sont accessibles à l’aide de la requête de classement global habituelle, GET (/scids/{scid}/leaderboards/{leaderboardname}), en ajoutant la requête suivante à l’URL : &viewTarget=people&view=people. Pour prendre en charge les vues de classement à plusieurs colonnes, il est possible d’utiliser les métadonnées des statistiques. Un titre peut définir des champs de métadonnées pour une statistique de classement, qui peuvent être renvoyés lors de l’interrogation des rangs du classement. Un titre ne doit pas utiliser l’URI de traitement par lots des statistiques utilisateur pour obtenir le même comportement, car les paramètres de confidentialité peuvent empêcher l’accès aux statistiques.

​

Classements à plusieurs colonnes

Dans certains cas, vous aurez besoin de colonnes supplémentaires dans un classement pour enrichir la statistique. Par exemple, pour un classement du plus grand nombre d’ennemis vaincus, vous pouvez ajouter l’arme utilisée par le joueur, la carte sur laquelle cela s’est produit, le type d’ennemi le plus vaincu et le ratio éliminations/morts. Les classements XBOX intègrent la prise en charge de plusieurs colonnes. Vous pouvez facilement obtenir ces types de classements. La seule condition préalable est que la statistique utilisée pour le classement ait un contexte de statistique défini. C’est ce qui sera utilisé comme métadonnées supplémentaires. Par exemple, pour une statistique FastestLap, vous pouvez configurer ces propriétés supplémentaires comme contexte de statistique. Voici une capture d’écran montrant à quoi elles pourraient ressembler. Maintenant que la statistique est conservée avec son contexte, le classement à plusieurs colonnes récupéré ressemblerait au tableau suivant. Les classements à plusieurs colonnes sont actuellement pris en charge dans les classements globaux et dans les classements globaux avec une vue sociale. Toutefois, si vous souhaitez créer un classement social à plusieurs colonnes, vous pouvez utiliser l’appel de traitement par lots des statistiques utilisateur pour obtenir toutes les statistiques avec leur contexte, puis créer manuellement le classement. Les classements à plusieurs colonnes ne sont accessibles que via notre API REST, à l’aide de la requête de classement global habituelle, GET (/scids/{scid}/leaderboards/{leaderboardname}), en ajoutant la requête suivante à l’URL : &include=valuemetadata.

​

Où apparaissent les classements avec des statistiques mises en avant

Les classements comparent les joueurs en affichant certaines statistiques d’un jeu. Les classements sont un excellent moyen d’encourager la compétition entre vos joueurs. Ils maintiennent l’engagement des joueurs qui cherchent à battre leur meilleur score précédent et les scores de leurs amis.

• Les classements des statistiques mises en avant sont toujours affichés dans le club officiel d’un titre.
• Les classements des statistiques mises en avant sont parfois affichés dans d’autres expériences XBOX, par exemple dans la vue des succès du profil d’un joueur.
• Vous pouvez également utiliser les statistiques mises en avant que vous avez configurées pour créer des classements dans votre titre.

​

Choisir de bons classements

Un classement correspond à une statistique que vous avez définie. Vous devez choisir des classements qui correspondent à un accomplissement qu’un joueur peut chercher à améliorer. Par exemple, le meilleur temps au tour dans un jeu de course est un bon classement, car les joueurs veulent améliorer leur meilleur temps au tour. D’autres exemples sont le ratio éliminations/morts pour les jeux de tir ou la taille maximale de combo dans un jeu de combat.

​

Quand afficher les classements

Vous pouvez afficher les classements à tout moment dans votre titre. Choisissez un moment où le classement n’interfère pas avec le gameplay ou le déroulement de votre titre. Par exemple, entre les manches et après les matchs sont de bons moments pour afficher les classements.

​

Guide de programmation

Plusieurs API Leaderboard permettent d’obtenir l’état actuel d’un classement. Toutes les API sont asynchrones et non bloquantes. Envoyez une demande pour obtenir les données du classement et poursuivez le traitement habituel de votre jeu. Lorsque les résultats du classement sont renvoyés par le service, vous pouvez les afficher au moment opportun. Demandez les données du classement au service un peu avant le moment où vous souhaitez les afficher. Cela évite que les joueurs soient bloqués en attendant l’affichage du classement.

​

Voir aussi

Statistiques basées sur les événements et statistiques gérées par le titre.