Démarrage rapide : définir et obtenir des données de joueur

Dans les API PlayFab, les noms de fonctions utilisent le terme UserData. Dans Game Manager, ce concept est désigné par Player Data. Ils sont identiques et interchangeables.

Commencez à utiliser PlayFab Player Data. Ce démarrage rapide vous montre comment définir et récupérer des données de joueur à l’aide de C# dans Unity et de PlayFab CloudScript. Les données des joueurs sont des informations qui s’appliquent à un joueur individuel ou à un groupe de joueurs (données partagées) et que PlayFab stocke sous forme de paires clé/valeur (KVP). Cet article couvre les appels d’API client, qui peuvent être effectués en toute sécurité depuis n’importe quel processus ou contexte. Il couvre également les appels d’API serveur, qui ne doivent être effectués que depuis un processus de serveur dédié que vous contrôlez, ou depuis un appel CloudScript soigneusement sécurisé. Les API serveur nécessitent votre clé secrète de développeur. Cette clé ne doit pas être fournie à votre client ni publiée avec celui-ci.

Exigences

Un compte de développeur PlayFab.
Une copie installée de l’éditeur Unity. Pour installer Unity pour un usage personnel au moyen de Unity Hub, ou Unity+ pour un usage professionnel, consultez Télécharger Unity.

Le SDK PlayFab Unity3D prend en charge l’éditeur Unity version 5.3 (publiée en décembre 2015) et ultérieure.

Un projet Unity, qui peut être :
- Un tout nouveau projet. Pour plus d’informations, consultez Démarrer Unity pour la première fois.
- Un projet de tutoriel guidé. Pour plus d’informations, consultez Bien démarrer avec Unity.
- Un projet existant.
Le SDK PlayFab Unity3D.

Pour plus d’informations sur la configuration du SDK PlayFab Unity3D, consultez l’article Démarrage rapide : bibliothèque cliente PlayFab pour C# dans Unity. Cet article vous permet de vérifier que vous disposez d’un compte PlayFab et que vous avez correctement configuré le SDK Unity3D.

À propos des exemples de code

Les exemples C# de cet article sont écrits pour le SDK Unity. Le SDK Unity utilise un modèle piloté par les événements pour gérer les tâches non synchrones. Pour exécuter l’exemple de code avec le SDK C#, vous devez modifier le code afin d’utiliser un modèle de tâches asynchrones (async Task). Le nom des méthodes à modifier est suivi du suffixe Async dans leur signature. Par exemple, SetObject dans le SDK Unity devient SetObjectAsync dans le SDK C#. Pour plus d’informations, consultez Programmation asynchrone avec async et await. Bien que vous puissiez utiliser un projet Unity existant, ce démarrage rapide suppose que vous utilisez l’exemple créé à l’issue du Démarrage rapide : bibliothèque cliente PlayFab pour C# dans Unity.

Données des joueurs dans Game Manager

Vous pouvez toujours obtenir et définir des données de joueur au moyen de Game Manager en procédant comme suit.

Ouvrez Game Manager. Si vous ne le connaissez pas, consultez le démarrage rapide de Game Manager.
Sélectionnez l’onglet Players.
Sélectionnez le nom du joueur pour accéder à l’onglet Players Account.
Sélectionnez l’onglet Player Data pour afficher ses données.

Ajouter une méthode pour définir et récupérer les données du joueur

Dans l’éditeur Unity, ouvrez votre exemple de projet.
Dans la fenêtre Project, ouvrez Assets > Scripts, puis ouvrez le script PlayFabLogin.
Dans Visual Studio, ajoutez ce qui suit à l’instruction using : using System.Collections.Generic;

Pour définir des données de joueur, ajoutez une méthode SetUserData à la classe PlayFabLogin. SetUserData utilise la méthode UpdateUserData pour créer ou mettre à jour les données du joueur connecté. La méthode crée (ou met à jour, si les paires clé-valeur (KVP) existent déjà) les KVP Ancestor avec la valeur Arthur, et Successor avec la valeur Fred.

void SetUserData() {
    PlayFabClientAPI.UpdateUserData(new UpdateUserDataRequest() {
        Data = new Dictionary<string, string>() {
            {"Ancestor", "Arthur"},
            {"Successor", "Fred"}
        }
    },
    result => Debug.Log("Successfully updated user data"),
    error => {
        Debug.Log("Got error setting user data Ancestor to Arthur");
        Debug.Log(error.GenerateErrorReport());
    });
}

Pour obtenir des données de joueur, ajoutez une méthode GetUserData à la classe PlayFabLogin. SetUserData utilise la méthode GetUserData pour récupérer les données du joueur spécifié.

void GetUserData(string myPlayFabId) {
    PlayFabClientAPI.GetUserData(new GetUserDataRequest() {
        PlayFabId = myPlayFabId,
        Keys = null
    }, result => {
        Debug.Log("Got user data:");
        if (result.Data == null || !result.Data.ContainsKey("Ancestor")) Debug.Log("No Ancestor");
        else Debug.Log("Ancestor: "+result.Data["Ancestor"].Value);
    }, (error) => {
        Debug.Log("Got error retrieving user data:");
        Debug.Log(error.GenerateErrorReport());
    });
}

Appelez SetUserData et GetUserData dans la méthode OnLoginSuccess.

private void OnLoginSuccess(LoginResult result) {
    Debug.Log("Congratulations, you made your first successful API call!");
    SetUserData();
    GetUserData(result.PlayFabId);
}

Enregistrez le fichier.

Exécuter l’exemple

Dans l’éditeur Unity, sélectionnez le bouton de lecture. En cas de réussite, les résultats des appels s’affichent dans la fenêtre de la console.

XBOX Services

PlayFab

Démarrage rapide des données des joueurs

Démarrage rapide : définir et obtenir des données de joueur

Exigences

À propos des exemples de code

Données des joueurs dans Game Manager

Ajouter une méthode pour définir et récupérer les données du joueur

Exécuter l’exemple

Voir aussi

​Démarrage rapide : définir et obtenir des données de joueur

​Exigences

​À propos des exemples de code

​Données des joueurs dans Game Manager

​Ajouter une méthode pour définir et récupérer les données du joueur

​Exécuter l’exemple

​Voir aussi

Démarrage rapide : définir et obtenir des données de joueur

Exigences

À propos des exemples de code

Données des joueurs dans Game Manager

Ajouter une méthode pour définir et récupérer les données du joueur

Exécuter l’exemple

Voir aussi