Utilisation des statistiques des joueurs - XBOX Game Development Documentation

Ce tutoriel décrit comment créer et utiliser des statistiques de joueurs. Les statistiques des joueurs sont stockées sous forme de paires clé-valeur (KVP), où la clé est une chaîne et la valeur est un entier de 32 bits (pour la compatibilité avec les langages qui ne prennent pas en charge le 64 bits). Les statistiques des joueurs sont aussi utilisées par les classements, mais ce guide traite exclusivement des statistiques des joueurs. Si vous souhaitez en savoir plus sur la façon dont les statistiques des joueurs et les classements fonctionnent ensemble, lisez notre tutoriel Utilisation des statistiques et des classements réinitialisables.

Dans certaines documentations et certains appels d’API, vous pourriez trouver le terme UserStatistics. Aux fins de cette discussion, les termes utilisateur et joueur sont identiques et interchangeables. Dans la page Game Manager, l’onglet Players donne accès aux utilisateurs/joueurs de votre titre et, à l’intérieur de celui-ci, à leurs statistiques. Les statistiques des joueurs désignent précisément l’information liée à un joueur, et non l’information analytique sur le joueur.

API client

Le client a accès en lecture aux statistiques des joueurs, mais pour prévenir la triche, le client ne peut pas mettre à jour les statistiques par défaut. Pour activer cette fonctionnalité :

Connectez-vous à PlayFab
Sélectionnez votre titre.
Sélectionnez Settings dans le menu de gauche.
Sélectionnez l’onglet API Features.
Trouvez et activez Allow client to post player statistics.

Cette opération désactive une couche de sécurité pour votre titre, permettant aux joueurs de publier des scores arbitraires dans toutes leurs statistiques. Si votre jeu comporte le moindre aspect compétitif, nous vous recommandons de ne jamais publier de statistiques à partir du client.

Les statistiques sont des informations publiques

Il n’existe aucune statistique privée ou réservée au serveur. Un joueur peut toujours lire toutes ses propres statistiques au moyen de GetPlayerStatistics, et peut lire les statistiques de tous les autres joueurs au moyen des appels d’API de classement. C’est le cas même si vous n’affichez pas une statistique dans le jeu ou n’utilisez pas de classements. La seule exception serait si vous désactivez des fonctionnalités client au moyen de notre stratégie d’accès aux API. Consultez ce lien pour en savoir plus sur l’utilisation des paramètres de stratégie pour les titres, car il s’agit d’un sujet avancé qui n’est pas couvert par ce tutoriel.

Définir des statistiques

Le code Unity/C# suivant crée (ou met à jour s’il existe déjà) une valeur de statistique de force pour un joueur.

PlayFabClientAPI.UpdatePlayerStatistics( new UpdatePlayerStatisticsRequest {
    // request.Statistics is a list, so multiple StatisticUpdate objects can be defined if required.
    Statistics = new List<StatisticUpdate> {
        new StatisticUpdate { StatisticName = "strength", Value = 18 },
    }
},
result => { Debug.Log("User statistics updated"); },
error => { Debug.LogError(error.GenerateErrorReport()); });

Obtenir des statistiques

Le code Unity/C# suivant récupère toutes les valeurs de statistiques actuelles d’un joueur.

void GetStatistics()
{
    PlayFabClientAPI.GetPlayerStatistics(
        new GetPlayerStatisticsRequest(),
        OnGetStatistics,
        error => Debug.LogError(error.GenerateErrorReport())
    );
}

void OnGetStatistics(GetPlayerStatisticsResult result)
{
    Debug.Log("Received the following Statistics:");
    foreach (var eachStat in result.Statistics)
        Debug.Log("Statistic (" + eachStat.StatisticName + "): " + eachStat.Value);
}

Méthode d’agrégation

PlayFab prend en charge quelques options pratiques pour l’agrégation des statistiques. Les quatre options sont :

Last
Min
Max
Sum

Vous pouvez créer une définition de statistique au moyen de l’appel d’API CreatePlayerStatisticDefinition, bien que ce ne soit pas obligatoire. Tout appel visant à mettre à jour une statistique de joueur pour le titre créera automatiquement la définition de statistique par défaut, à l’aide de la méthode d’agrégation Last. Pour modifier la méthode d’agrégation d’une statistique, vous pouvez utiliser Game Manager ou l’appel d’API UpdatePlayerStatisticDefinition. Pour modifier une définition de statistique dans Game Manager :

Connectez-vous à PlayFab
Sélectionnez votre titre.
Sélectionnez Leaderboards dans le menu de gauche (les statistiques et les classements sont étroitement liés).
Sélectionnez la statistique existante que vous souhaitez modifier, ou -
Sélectionnez le bouton New Leaderboard.
- Pour une statistique existante, vous aurez une autre page, avec un bouton Edit Leaderboard.
À ce stade, vous devriez voir la page illustrée ci-dessous.

Quelques exemples d’utilisation de l’agrégation des statistiques :

Max et Min peuvent servir à enregistrer les meilleurs/pires scores, comme les tirs à la tête ou la précision :
- En bref, ils appliquent la règle suivante : si cette valeur est plus élevée (ou plus basse) que le score existant, mettre à jour le score.
- Publiez la statistique à la fin de la session, et l’agrégation Min/Max détermine s’il faut effectuer la mise à jour ou non.
- Ces méthodes peuvent être très utiles pour les classements réinitialisables, ainsi que pour une règle PlayStream qui accorde des succès.
Sum pourrait servir à enregistrer des points d’expérience :
- Vous publiez l’expérience acquise lors de ce combat, et elle est ajoutée à la valeur de statistique existante du joueur.
Last vous permet de gérer la statistique vous-même :
- Chaque fois que vous publiez une statistique, la valeur la plus récente est utilisée.

Classements

Un classement est généré pour toutes les statistiques enregistrées dans PlayFab. L’accès au classement d’une statistique précise est facultatif. La fréquence de réinitialisation et les méthodes d’agrégation jouent un rôle majeur dans le dynamisme des classements de votre jeu. La fonctionnalité Tournaments se concentre sur les classements avec des fréquences de réinitialisation automatique, et est décrite dans le tutoriel Utilisation des statistiques et des classements réinitialisables. Nous vous encourageons à utiliser les statistiques de toutes les façons pertinentes pour votre jeu. Vous pouvez utiliser côte à côte des statistiques réinitialisables pour organiser des tournois quotidiens et des statistiques à long terme comme les points d’expérience.

​API client

​Les statistiques sont des informations publiques

​Définir des statistiques

​Obtenir des statistiques

​Méthode d’agrégation

​Classements

API client

Les statistiques sont des informations publiques

Définir des statistiques

Obtenir des statistiques

Méthode d’agrégation

Classements