Passer au contenu principal
Ce tutoriel montre comment accéder aux états archivés des classements. Chaque classement peut être réinitialisé manuellement ou automatiquement, ce qui signifie que les valeurs de statistiques seront supprimées pour tous les joueurs, menant à un état vierge, et que la version du classement sera incrémentée. Avant que cela se produise, toutefois, PlayFab crée un instantané de toutes les valeurs de statistiques du classement pour chaque joueur. Cela vous permet d’accéder à cette version archivée du classement.
Tous les titres vous permettent d’accéder à la version archivée la plus récente d’un classement, ce qui vous donne la version actuelle et la version précédente. Par exemple, si la version actuelle de votre classement est 3, vous pouvez accéder uniquement à la version 3 et à la version archivée 2.

Configuration initiale

Avant d’utiliser ce guide, assurez-vous d’avoir déjà quelques joueurs inscrits pour le titre. La capture d’écran suivante montre 5 joueurs inscrits artificiellement à l’aide de l’appel d’API LoginWithCustomID. Game Manager - Joueurs - Connexions les plus récentes

Définir et simuler un classement

Dans cette étape, nous allons créer un classement à des fins de test. Nous simulerons ensuite le processus d’itération du classement en le remplissant et en le réinitialisant à plusieurs reprises. Ouvrez Game Manager :
  1. Accédez à la section Leaderboards.
  2. Sélectionnez le bouton New Leaderboard, comme illustré ci-dessous.
Pour configurer le nouveau classement :
  1. Définissez le nom de Statistic à TestScore.
  2. Conservez la valeur Manually pour Reset Frequency.
  3. Laissez la méthode Aggregation par défaut.
  4. Soumettez en sélectionnant Save Leaderboard.
Game Manager - Classements - Nouveau classement - Propriétés Vous arriverez sur la nouvelle page Leaderboards, qui affichera des données vides (voir ci-dessous). Game Manager - Classements - Modifier le classement

Début de la section de test

La section suivante est un exemple de la façon de remplir des données de test aux fins de cet exemple. Votre vrai jeu remplira ces données de manière plus naturelle.
Notre prochaine étape consiste à simuler des données pour notre classement. La façon la plus rapide de le faire est de créer un gestionnaire CloudScript, qui définira des statistiques aléatoires pour un joueur donné. Nous invoquerons ce gestionnaire pour chaque joueur du segment All Players. Ainsi, chaque joueur obtiendra une valeur de statistique aléatoire, ce qui constitue une approximation suffisamment bonne d’un scénario réel. Commençons par définir notre CloudScript (consultez les commentaires du code pour plus d’information).
Téléversons le CloudScript. À l’aide de Game Manager :
  1. Accédez à l’onglet Automation.
  2. Accédez ensuite au sous-onglet CloudScript.
  3. Insérez le code CloudScript.
  4. Sélectionnez Save as Revision.
  5. Enfin, sélectionnez Deploy Revision.
Game Manager - Automatisation - CloudScript - téléverser le CloudScript Ensuite, nous devons définir une tâche pour exécuter notre CloudScript sur un segment précis :
  1. Accédez à l’onglet Players.
  2. Accédez ensuite au sous-onglet Segments.
Par défaut, PlayFab génère un segment All Players pour vous. Ce segment est particulièrement utile lorsque vous avez besoin de tous les joueurs inscrits dans votre titre (ce qui est exactement notre cas).
  1. Sélectionnez le segment All Players.
  2. Enfin, sélectionnez Run Task….
Si aucun segment All Players ne figure dans la liste, consultez notre démarrage rapide sur la segmentation des joueurs pour en créer un.
Game Manager - Joueurs - Segments - Tous les joueurs - Exécuter une tâche Pour configurer la tâche :
  1. Définissez le Name.
  2. Assurez-vous que le type de tâche est défini à Run actions on each Player in a Segment.
    • Vérifiez également que All Players est sélectionné sous Segment.
  3. Ajoutez une nouvelle Action.
  4. Sélectionnez Execute CloudScript sous Type.
  5. Sélectionnez ensuite le gestionnaire PopulateLeaderboard sous CloudScript Function.
  6. Enfin, sélectionnez le bouton Save and Run.
Game Manager - Configurer la tâche
  • Assurez-vous que le résultat de l’exécution est Successful.
Game Manager - Exécution de la tâche réussie

Fin de la section de test

Remplir les données de test

  1. Accédez de nouveau à l’onglet Leaderboards.
  2. Sélectionnez notre Leaderboard.
Game Manager - Classements - Test Score
  1. Vous verrez que votre Leaderboard a été rempli de valeurs aléatoires.
  2. Réinitialisez le Leaderboard.
Réinitialiser le classement Test Score Cela créera un instantané de toutes les données dont nous disposons actuellement, puis annulera les valeurs de statistiques de chaque joueur et incrémentera la version.
  • Une fois votre classement réinitialisé, exécutez de nouveau la tâche CloudScript.
  • Répétez cette opération 2 ou 3 fois, puis réinitialisez et remplissez de nouveau.
Vous obtiendrez plusieurs versions du Leaderboard (1) :
  • Les données de la version actuelle seront affichées dans le tableau de gauche (3).
  • Les données archivées seront disponibles pour les versions précédentes (2).
  • Seule la dernière version sera disponible. Cela s’applique à tous les titres.
Game Manager - Classements - Versions du classement

Accéder aux données archivées à l’aide de Game Manager

Vous pouvez accéder aux résultats archivés directement à partir de la page Leaderboard :
  1. Accédez à l’onglet Leaderboards.
  2. Sélectionnez le Leaderboard dont vous avez besoin.
Game Manager - Classements - Sélectionner un classement
  1. Si votre Leaderboard contient des révisions archivées, vous pourrez télécharger les données JSON à l’aide du lien de téléchargement illustré dans la capture d’écran ci-dessous.
Game Manager - Classements - Télécharger la révision archivée

Accéder aux données archivées à l’aide de l’API

Le code suivant vous permet d’extraire la dernière version (actuelle) du classement.
Le résultat ressemblera à l’exemple ci-dessous. Sortie de débogage - Afficher les versions du classement Vous pouvez également spécifier la version du classement que vous souhaitez charger.
Le résultat ressemblera à l’exemple ci-dessous. Sortie de débogage - Afficher la version 1 du classement Tous les titres vous permettent d’accéder à la dernière version archivée du classement. Toute tentative d’extraire une version plus ancienne entraînera une erreur (voir ci-dessous). Erreur - Version du classement non disponible Les mêmes règles s’appliquent à toutes les requêtes de classement. Consultez la documentation de l’objet GetLeaderboardResult pour en savoir plus sur les propriétés utiles que vous pouvez obtenir avec les données du classement.
Dernière modification le 6 octobre 2026