Utilisation des tables de prix

​

Configuration requise

• Des connaissances de base sur la création d’un joueur seront nécessaires, car il doit y avoir des joueurs dans un classement avant que celui-ci puisse effectuer des actions sur ces joueurs.
• Il est également utile de lire le démarrage rapide de Game Manager si vous ne connaissez pas Game Manager, car c’est là que les tables de prix sont créées.
• Pour utiliser les tables de prix, vous devez avoir des connaissances générales sur le fonctionnement des classements réinitialisables. Consultez les informations sur les classements dans notre tutoriel Utilisation des statistiques et classements réinitialisables.
• De plus, des monnaies virtuelles doivent être configurées. Lisez notre tutoriel sur les monnaies et configurez deux monnaies avec les paramètres suivants :
  • Code de monnaie : GO
  • Nom d’affichage : Gold
  • Dépôt initial : 200
  • Code de monnaie : SI
  • Nom d’affichage : Silver
  • Dépôt initial : 1000

​

Étape 1 - Créer un classement

• Accédez à Leaderboards dans le menu de gauche.
• Sélectionnez New Leaderboard.
• Ajoutez un Leaderboard nommé tournamentScore_manual dans le champ Statistic name.
• À l’aide du menu déroulant fourni, définissez le champ Reset frequency sur Manually.
• Passez au champ Aggregation method et sélectionnez Maximum (always use the highest value) dans le menu déroulant fourni.

​

Étape 2 - Créer une table de prix pour le classement

• Leaderboards dans le menu de gauche.
• Sélectionnez l’onglet Prize Tables.
• Sélectionnez le bouton NEW PRIZE TABLE pour accéder à la vue New Prize Table.

• Accédez à la zone INFO et saisissez le Name de la New Prize Table, intitulée End Tournament Prizes.
• Choisissez tournamentScore_manual dans le menu déroulant Leaderboard.

• Sélectionnez + ADD RANK dans la section TABLE CONTENTS.
• Un formulaire Rank apparaît.

• Vérifiez que le champ Rank from a la valeur 1.
• Vérifiez que le champ To (inclusive) a la valeur 2.
• Dans le menu déroulant Type, choisissez Grant virtual currency.
• Dans le menu déroulant virtual currency code, choisissez GO (Gold) avec un montant de 10.

• Sélectionnez +ADD RANK dans la section TABLE CONTENTS (il en existe également un deuxième en bas, qui fonctionne aussi).
• Dans le formulaire Rank qui apparaît, assurez-vous que le champ Rank from a la valeur 3 et que le champ To (inclusive) a la valeur 5.
• Dans le menu déroulant Virtual currency code, choisissez SI (Silver) avec un montant de 10.

​

Étape 3 - Remplir le classement avec un joueur

• Sélectionnez Settings dans le menu de gauche.
• Sélectionnez l’onglet API Features.
• Cochez la case Allow client to post player statistics.
• Sélectionnez ensuite le bouton SAVE API FEATURES en bas de l’écran.

​

Exemple de code C#

// Note: This is a recursive function. Invoke it initially with no parameter
public void CreatePlayerAndPopulateLeaderboard(int playerIndex = 5) {
    if (playerIndex <= 0) return;
    const string leaderboardName = "tournamentScore_manual";
    PlayFabClientAPI.LoginWithCustomID(new LoginWithCustomIDRequest {
        CustomId = playerIndex.ToString(),
        CreateAccount = true
    }, result => OnLoggedIn(result,playerIndex,leaderboardName), FailureCallback);
}

private void OnLoggedIn(LoginResult loginResult, int playerIndex, string leaderboardName) {
    Debug.Log("Player has successfully logged in with " + loginResult.PlayFabId);
    PlayFabClientAPI.UpdatePlayerStatistics(new UpdatePlayerStatisticsRequest {
        Statistics = new List<StatisticUpdate> {
            new StatisticUpdate {
                StatisticName = leaderboardName,
                Value = playerIndex + 100
            }
        }
    }, result=> OnStatisticsUpdated(result,playerIndex), FailureCallback);
}

private void OnStatisticsUpdated(UpdatePlayerStatisticsResult updateResult, int playerIndex) {
    Debug.Log("Successfully updated player statistic");
    // Recursively invoke for next player
    CreatePlayerAndPopulateLeaderboard(playerIndex - 1);
}

private void FailureCallback(PlayFabError error){
    Debug.LogWarning("Something went wrong with your API call. Here's some debug information:");
    Debug.LogError(error.GenerateErrorReport());
}

​

Vérifier les résultats de l’exemple de code C#

• Sélectionnez Leaderboards dans le menu de gauche.
• Dans l’onglet Leaderboards, revenez à la vue de liste Leaderboard.
• Sélectionnez tournamentScore_manual ; il devrait y avoir 5 Players avec les valeurs 105, 104, 103, 102 et 101.

​

Étape 4 - Vérifier les monnaies initiales du joueur

• Revenez à Players dans le menu de gauche depuis l’étape 2.
• Accédez à l’onglet Players et recherchez un joueur qui a été placé dans le Leaderboard tournamentScore_manual à l’étape 3.
• Sélectionnez le Player ID, puis l’onglet Virtual Currency de ce joueur.
• Notez les valeurs des Currencies GO (Gold) et SI (Silver) de ce joueur.

• Accédez à Players et recherchez-en un qui a été placé dans le Leaderboard tournamentScore_manual à l’étape 3.
• Sélectionnez le Player ID, puis l’onglet Virtual Currency de ce joueur.
• Notez les valeurs des monnaies GO (Gold) et SI (Silver) de ce joueur.
• Faites maintenant de même pour les 4 autres des 5 joueurs placés dans le Leaderboard tournamentScore_manual à l’étape 3.
• Veillez à noter les valeurs de leurs monnaies GO (Gold) et SI (Silver) (elles seront importantes pour confirmer que la table de prix a fonctionné après la réinitialisation).

​

Étape 5 - Réinitialiser le classement pour attribuer les récompenses

• Revenez à la vue de liste Leaderboards.
• Sélectionnez tournamentScore_manual.
• Notez les positions des Players dans le Leaderboard (elles sont indexées à partir de zéro : la position 0 correspond donc à la première place).
• Sélectionnez le bouton RESET NOW.
• Sélectionnez le bouton RESET pour confirmer la réinitialisation du Leaderboard
• Cela videra la liste Players.

• Sélectionnez le bouton RESET NOW en haut de l’écran.
• Lorsque le message Reset this Leaderboard now? s’affiche, sélectionnez le bouton RESET pour confirmer la réinitialisation.
• Cela videra la liste Players.

​

Étape 6 - Vérifier que la table de prix fonctionne

• Sélectionnez Players dans le menu de gauche.
• L’onglet PlayStream affiche un événement de classement d’un Player dans un Leaderboard, suivi d’une mise à jour de Virtual Currency.

• Sélectionnez Players dans le menu de gauche.
• Dans l’onglet Players, accédez à la zone Virtual Currency de l’écran.
• Vérifiez que la monnaie a été attribuée correctement.
• Le montant devrait être supérieur à celui noté précédemment.
• Notez que les Players aux positions 0 ou 1 du classement ont gagné 10 gold sans recevoir de silver.
• Les Players aux positions 2, 3 et 4 ont quant à eux reçu 10 silver et pas de gold.
• Cela correspond aux actions configurées pour la table de prix.

• Accédez à Players.
• Consultez l’Event History.
• Un événement player_virtual_currency_balance_changed s’affiche, avec des détails précis sur les montants modifiés pour la Virtual Currency attribuée.