Prérequis
Avant de commencer, assurez-vous d’avoir :- Terminé la configuration du SDK Core et l’authentification
- Un
PFEntityHandleauthentifié issu du processus de connexion - Votre ID de titre PlayFab et votre configuration de service en place
Ce guide suppose que vous avez déjà initialisé le SDK PlayFab et authentifié un joueur en suivant le guide de démarrage rapide Core. Si ce n’est pas le cas, suivez d’abord ce guide.
Ce que vous allez accomplir
À la fin de ce démarrage rapide, vous aurez :- Récupéré la clé d’entité d’un joueur authentifié
- Effectué votre premier appel d’API de service PlayFab
- Traité la réponse d’un service PlayFab
Effectuer votre premier appel d’API de service
Après une authentification réussie, vous pouvez effectuer des appels d’API PlayFab à l’aide duPFEntityHandle obtenu lors de la connexion. Cet exemple montre comment récupérer les fichiers stockés pour le joueur actuel.
Étape 1 : obtenir la clé d’entité
Tout d’abord, récupérez la clé d’entité à partir de votre handle d’entité authentifié :Étape 2 : appeler l’API GetFiles
Effectuez maintenant votre premier appel de service PlayFab pour obtenir les fichiers associés au joueur :Comprendre le modèle d’appel d’API
Tous les appels d’API de service PlayFab suivent un modèle similaire :- Préparer la requête : créez et renseignez une structure de requête
- Lancer l’appel asynchrone : appelez la fonction
*Async - Attendre la fin : utilisez
XAsyncGetStatuspour attendre la fin de l’opération - Obtenir la taille du résultat : appelez
*GetResultSizepour déterminer la taille de mémoire tampon nécessaire - Récupérer le résultat : appelez
*GetResultpour obtenir les données proprement dites
Étapes suivantes
Maintenant que vous avez appelé avec succès un service PlayFab, découvrez ces fonctionnalités supplémentaires :API de service courantes
- Gestion des données des joueurs : stockez et récupérez des données de joueur personnalisées
- Statistiques des joueurs : suivez les statistiques et les succès des joueurs
- Données de titre : accédez aux données de configuration du jeu
- Cloud Script : exécutez une logique côté serveur
Fonctionnalités avancées
- Classements : implémentez des fonctionnalités compétitives avec des classements
- Économie et monétisation : ajoutez des monnaies virtuelles et des objets
- Multijoueur : intégrez les services de matchmaking et de lobby
- Analytique : suivez le comportement des joueurs et les métriques du jeu
Bonnes pratiques
- Opérations asynchrones : comprendre le modèle de programmation asynchrone de PlayFab
- Gestion de la mémoire : bonnes pratiques de gestion de la mémoire du SDK
- Traçage et diagnostics : déboguer et surveiller votre intégration
Résolution des problèmes
Problèmes courants et solutions :
Pour obtenir des informations plus détaillées sur les erreurs, activez le traçage et les diagnostics dans votre application.
