Classer les joueurs selon les statistiques

Dans ce didacticiel, nous allons apprendre à utiliser conjointement les services Leaderboards et Statistics. Le résultat final est que, lorsqu’une statistique est mise à jour sur une entité, la modification est automatiquement répercutée dans le classement correspondant. Pour plus d’informations sur PlayFab Statistics, consultez [Vue d’ensemble de Statistics](Vue d’ensemble de PlayFab Statistics). Commençons par l’exemple d’un jeu de tir qui utilise les deux services. Nous allons nous appuyer sur le didacticiel Créer une statistique de base et partir du principe que nous avons déjà créé des statistiques pour le jeu. Nous voulons maintenant suivre les tirs de loin chaque fois qu’un joueur en réussit un pendant une partie. Nous allons avoir une statistique qui enregistre le meilleur tir de loin d’un joueur et un classement des meilleurs joueurs en tirs de loin.

Création d’un classement lié à une statistique

La première étape consiste à créer une définition de classement qui peut prendre en entrée les informations suivies par le service Statistics. L’exemple suivant montre comment créer la définition de classement à l’aide du SDK C#.

public static async Task CreateStatLinkedLeaderboardDefinitionAsync(PlayFabAuthenticationContext context, string leaderboardName, string statName)
{
    PlayFabProgressionInstanceAPI leaderboardsAPI = new PlayFabProgressionInstanceAPI(context);
    CreateLeaderboardDefinitionRequest leaderboardDefinitionRequest = new CreateLeaderboardDefinitionRequest()
    {
        AuthenticationContext = context,
        EntityType = EntityType,
        Name = leaderboardName,
        SizeLimit = 1000,
        VersionConfiguration = new VersionConfiguration()
        {
            MaxQueryableVersions = 1,
            ResetInterval = ResetInterval.Manual,
        },
        Columns = new List<LeaderboardColumn>()
        {
            new LeaderboardColumn()
            {
                Name = "Distance",
                SortDirection = LeaderboardSortDirection.Descending,
                LinkedStatisticColumn = new LinkedStatisticColumn()
                {
                    LinkedStatisticName = statName,
                    LinkedStatisticColumnName = "Distance",
                }
            },
            new LeaderboardColumn()
            {
                Name = "Caliber of the bullet",
                SortDirection = LeaderboardSortDirection.Ascending,
                LinkedStatisticColumn = new LinkedStatisticColumn()
                {
                    LinkedStatisticName = statName,
                    LinkedStatisticColumnName = "Caliber",
                }
            }
        }
    };

    PlayFabResult<PlayFab.LeaderboardsModels.EmptyResponse> createLbDefinitionResult = await leaderboardsAPI.CreateLeaderboardDefinitionAsync(leaderboardDefinitionRequest);
}

Expliquons maintenant la principale différence avec les autres définitions de classement que nous avons créées précédemment. Notez l’objet LeaderboardColumn, avec une propriété appelée LinkedStatisticColumn, qui nous permet de créer un lien entre les statistiques et le classement. Nous devons spécifier le nom de la statistique et le nom de la colonne dans cette statistique pour effectuer le mappage. Ainsi, nous suivons la progression du joueur avec le service Statistics. Le service Leaderboards utilise ensuite ces informations pour alimenter le classement lié.

Dissocier une statistique d’un classement

Le service dispose également d’un mécanisme permettant de dissocier les statistiques du classement si nécessaire. Un développeur peut vouloir effectuer cette action pour plusieurs raisons, par exemple pour tester différentes configurations ou mapper différentes statistiques. L’exemple suivant montre comment dissocier les statistiques du classement à l’aide du SDK C#.

public static async Task UnlinkLeaderboard(PlayFabAuthenticationContext context, string statName, string leaderboardName)
{
    PlayFabProgressionInstanceAPI leaderboardsAPI = new PlayFabProgressionInstanceAPI(context);

    UnlinkLeaderboardFromStatisticRequest unlinkLbRequest = new UnlinkLeaderboardFromStatisticRequest()
    {
        AuthenticationContext = context,
        Name = leaderboardName,
        StatisticName = statName,
    };

    PlayFabResult<PlayFab.LeaderboardsModels.EmptyResponse> lbResponse = await leaderboardsAPI.UnlinkLeaderboardFromStatisticAsync(unlinkLbRequest);
}

Grâce à ces informations, nous pouvons lier et dissocier des statistiques des classements chaque fois que nécessaire. Certaines contraintes importantes sont à garder à l’esprit :

Les classements ne peuvent pas être mis à jour directement ; la mise à jour doit toujours passer par la statistique pour tirer parti du mécanisme automatique.
Les classements ne peuvent pas incrémenter leur version indépendamment de la statistique.
Les classements ne peuvent pas être supprimés sans passer par le processus de dissociation.

Conclusions

Dans ce didacticiel, nous avons appris à créer un classement alimenté par des statistiques, ainsi qu’à dissocier les services. Pour plus d’informations sur les autres fonctionnalités, consultez les pages suivantes :

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

Création d’un classement lié à une statistique

Dissocier une statistique d’un classement

Conclusions

​Création d’un classement lié à une statistique

​Dissocier une statistique d’un classement

​Conclusions

Création d’un classement lié à une statistique

Dissocier une statistique d’un classement

Conclusions