Aller plus loin avec les statistiques

Dans ce tutoriel, nous allons aborder des fonctionnalités plus avancées proposées par le service, telles que la création de statistiques à plusieurs colonnes et les différentes façons d’interroger les statistiques. Grâce à ces fonctionnalités, nous souhaitons repousser les limites de ce dont un service de statistiques devrait être capable. Nous prenons l’exemple d’un jeu de tir très compétitif pour montrer comment ces nouvelles fonctionnalités peuvent nous aider à résoudre certains problèmes. Dans ce jeu, plusieurs armes permettent au joueur de réussir un tir à longue distance. Nous voulons suivre non seulement la distance du tir, mais aussi le calibre de la balle utilisée.

Prérequis

Effectuez les étapes de Créer une statistique de base.

Création d’une définition de statistique à plusieurs colonnes

Pour commencer cet exemple, nous devons créer une définition de statistique plus complexe que la précédente. Nous allons définir plusieurs colonnes pour représenter les aspects clés du tir à longue distance : la distance et le calibre. L’exemple suivant montre comment créer la définition de statistique à l’aide du SDK C#.

public static async Task CreateStatisticDefinitionAsync(PlayFabAuthenticationContext context, string statName)
{
    PlayFabProgressionInstanceAPI statsAPI = new PlayFabProgressionInstanceAPI(context);
    CreateStatisticDefinitionRequest statDefinitionRequest = new CreateStatisticDefinitionRequest()
    {
        Name = statName,
        AuthenticationContext = context,
        EntityType = "title_player_account",
        VersionConfiguration = new VersionConfiguration()
        {
            MaxQueryableVersions = 1,
            ResetInterval = ResetInterval.Manual,
        },
        Columns = new List<StatisticColumn>()
        {
            new StatisticColumn()
            {
                Name = "Distance",
                AggregationMethod = StatisticAggregationMethod.Max,
            },
             new StatisticColumn()
            {
                Name = "Caliber",
                AggregationMethod = StatisticAggregationMethod.Min,
            }
        },
    };
    
    PlayFabResult<PlayFab.LeaderboardsModels.EmptyResponse> createStatDefResult = await statsAPI.CreateStatisticDefinitionAsync(statDefinitionRequest);
}

L’élément le plus important ici est le paramètre Columns, qui permet de définir plusieurs StatisticColumn afin que la statistique puisse avoir plusieurs valeurs. La seule exception concerne l’utilisation de l’agrégation Sum. En outre, le nombre maximal de colonnes autorisé est de 5.

Ajout de données à une statistique

Maintenant que notre statistique est créée, nous allons y ajouter des données. La principale différence par rapport à notre précédent tutoriel sur ce sujet est que nous devons désormais ajouter deux valeurs différentes. L’exemple suivant montre comment ajouter des données à notre statistique à l’aide du SDK C#.

public static async Task UpdateStatisticForPlayer(PlayFabAuthenticationContext context, string statName, string entityId, int score)
{
    PlayFabProgressionInstanceAPI statsAPI = new PlayFabProgressionInstanceAPI(context);
    UpdateStatisticsRequest updateStatRequest = new UpdateStatisticsRequest()
    {
        Entity = new PlayFab.LeaderboardsModels.EntityKey()
        {
            Id = entityId,
            Type = EntityType
        },
        AuthenticationContext = context,
        Statistics = new List<PlayFab.LeaderboardsModels.StatisticUpdate>() 
        {
            new PlayFab.LeaderboardsModels.StatisticUpdate() 
            {
                Name = statName,
                Scores = new List<string> { score.ToString(), score.ToString()},
            }
        }
    };

    PlayFabResult<UpdateStatisticsResponse> updateResult = await statsAPI.UpdateStatisticsAsync(updateStatRequest);
}

L’essentiel repose ici sur le paramètre Scores de la statistique à ajouter. Dans l’exemple de code, nous voyons deux valeurs différentes, toutes deux des chaînes ; il ne s’agit toutefois que d’une définition d’entrée au sein de la statistique. Ces valeurs sont traitées comme des nombres. La longueur de la liste des scores doit toujours correspondre au nombre de colonnes de la définition de statistique.

Récupération des données d’une statistique

Nous allons maintenant découvrir un moyen d’interroger plusieurs entités et d’obtenir toutes les statistiques associées à chacune d’elles. L’exemple suivant montre comment ajouter des données à notre statistique à l’aide du SDK C#.

public static async Task GetStatsForEntities(PlayFabAuthenticationContext context, string[] entityIds)
{
    PlayFabProgressionInstanceAPI statsAPI = new PlayFabProgressionInstanceAPI(context);

    GetStatisticsForEntitiesRequest request = new GetStatisticsForEntitiesRequest()
    {
        AuthenticationContext = context,
        Entities = entityIds.Select(entity => new PlayFab.LeaderboardsModels.EntityKey()
        {
            Id = entity,
            Type = EntityType
        }).ToList(),
    };

    PlayFabResult<GetStatisticsForEntitiesResponse> result = await statsAPI.GetStatisticsForEntitiesAsync(request);

    foreach (EntityStatistics entityStatistics in result.Result.EntitiesStatistics)
    {
        Console.WriteLine("Stats for entity: " + entityStatistics.EntityKey.ToString());
        foreach (var stat in entityStatistics.Statistics)
        {
            Console.WriteLine($"{stat.Name} : {string.Join('|', stat.Scores)}");
        }
    }

}

Départage des égalités

Lorsque nous disposons d’une définition de statistique à plusieurs colonnes, nous pouvons rencontrer un scénario nécessitant un départage. Ce mécanisme suit l’ordre dans lequel les colonnes ont été ajoutées. Chaque fois qu’une nouvelle valeur arrive, le système vérifie si elle remplit le critère d’agrégation de la première colonne. Si la valeur est identique, il vérifie alors le critère de la deuxième colonne. Ce comportement se poursuit pour les colonnes suivantes. Par exemple, nous pouvons avoir une statistique à trois colonnes :

La première colonne utilise l’agrégation Min.
La deuxième colonne utilise l’agrégation Max.
La troisième colonne utilise l’agrégation Last.

Si une nouvelle valeur arrive, elle doit être inférieure à celle de la première colonne, puis supérieure à celle de la deuxième colonne. Enfin, la troisième colonne utilise l’agrégation Last ; si la valeur satisfait aux deux premières validations, cette colonne est donc toujours mise à jour.

Conclusion

Dans ce tutoriel, nous avons appris à effectuer les opérations suivantes :

Créer une statistique à plusieurs colonnes
Interroger des statistiques
Comprendre le fonctionnement du départage des égalités.

XBOX Services

PlayFab

Prérequis

Création d’une définition de statistique à plusieurs colonnes

Ajout de données à une statistique

Récupération des données d’une statistique

Départage des égalités

Conclusion

Voir aussi

​Prérequis

​Création d’une définition de statistique à plusieurs colonnes

​Ajout de données à une statistique

​Récupération des données d’une statistique

​Départage des égalités

​Conclusion

​Voir aussi

Prérequis

Création d’une définition de statistique à plusieurs colonnes

Ajout de données à une statistique

Récupération des données d’une statistique

Départage des égalités

Conclusion

Voir aussi