Statistiques saisonnières

Dans ce tutoriel, nous expliquons le concept de gestion des versions des statistiques. Dans de nombreux cas, nous souhaitons disposer de différentes versions d’une même statistique. Par exemple, si un jeu comporte des saisons, il réinitialisera très probablement les statistiques au début de chaque nouvelle saison. Nous poursuivons avec l’exemple de Créer une statistique de base. Imaginez que notre jeu de tir devient très populaire. Le concept de saisons est donc introduit : chaque mois, le jeu lance une nouvelle saison thématique pour l’ensemble de la base de joueurs. Nous voulons donc conserver des statistiques indépendantes par saison.

Création d’une définition de statistique pour la gestion des versions

Dans l’exemple précédent, lors de la création d’une définition de statistique, nous avons évoqué l’importance du paramètre VersionConfiguration pour la gestion des versions. Nous expliquons ici comment l’utiliser et comment il fonctionne.

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 = 12,
            ResetInterval = ResetInterval.Month,
        },
        Columns = new List<StatisticColumn>()
        {
            new StatisticColumn()
            {
                Name = "Longshots",
                AggregationMethod = StatisticAggregationMethod.Max,
            }
        },
    };
    
    PlayFabResult<PlayFab.LeaderboardsModels.EmptyResponse> createStatDefResult = await statsAPI.CreateStatisticDefinitionAsync(statDefinitionRequest);
}

La principale différence de cet exemple par rapport à la statistique de base réside dans le paramètre VersionConfiguration. Ce paramètre nous permet de définir le paramètre MaxQueryableVersions, qui spécifie le nombre de versions d’une même statistique que nous pouvons interroger. Dans ce cas, nous le définissons sur 12 versions. Le paramètre ResetInterval définit la fréquence du processus de réinitialisation. Ce processus consiste à créer une statistique avec la même configuration que précédemment, mais sans aucune valeur, et le paramètre de version évolue comme suit : N = N + 1, avec N = 0 lors de la création de la définition de statistique. Par exemple, supposons que nous ayons une statistique dont le paramètre de version est égal à deux, avec une valeur donnée. Si nous incrémentons la version de cette statistique, nous obtenons une nouvelle statistique dont le paramètre de version est égal à trois, sans aucune valeur. La statistique précédente reste quant à elle dans le système et peut être interrogée. ResetInterval peut fonctionner de plusieurs façons. Dans cet exemple, la réinitialisation est mensuelle, mais elle peut être modifiée selon les besoins du développeur. Dans ce cas précis, cela signifie que le classement sera réinitialisé automatiquement chaque mois à partir du moment où il a été configuré. Nous prenons en charge les stratégies de réinitialisation suivantes :

Day
Hour
Manual
Month
Week

Référence de l’API : création d’une statistique

Incrémentation de la version d’une statistique

Avec cette nouvelle configuration, nous pouvons disposer de plusieurs versions de la même statistique pour différentes saisons. Mais que se passe-t-il si nous devons réinitialiser manuellement le classement en raison d’un problème et recommencer la saison? Dans ce cas, nous pouvons effectuer une réinitialisation manuelle à l’aide de l’API. Voici un exemple avec le SDK :

public static async Task ResetStatistic(PlayFabAuthenticationContext context, string statName)
{
    PlayFabProgressionInstanceAPI statsAPI = new PlayFabProgressionInstanceAPI(context);
    IncrementStatisticVersionRequest resetStatRequest = new IncrementStatisticVersionRequest()
    {
        AuthenticationContext = context,
        Name = statName,
    };

    PlayFabResult<PlayFab.LeaderboardsModels.IncrementStatisticVersionResponse> resetStatResponse = await statsAPI.IncrementStatisticVersionAsync(resetStatRequest);
}

Nous sommes maintenant prêts à relever tous les défis liés à la gestion des versions des statistiques. Un aspect important est que le nombre de définitions de statistiques que nous décidons de conserver sous forme de versions sera mesuré, car elles utilisent de le stockage au sein du service. Pour en savoir plus :

Statistiques.

Conclusions

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

Créer une statistique avec la stratégie de réinitialisation appropriée
Incrémenter la version d’une statistique

XBOX Services

PlayFab

Création d’une définition de statistique pour la gestion des versions

Incrémentation de la version d’une statistique

Conclusions

Voir aussi

​Création d’une définition de statistique pour la gestion des versions

​Incrémentation de la version d’une statistique

​Conclusions

​Voir aussi

Création d’une définition de statistique pour la gestion des versions

Incrémentation de la version d’une statistique

Conclusions

Voir aussi