Passer au contenu principal
Ce guide vous montre comment effectuer des appels d’API de service PlayFab à l’aide du SDK unifié. Vous apprendrez à appeler différents services PlayFab pour gérer les données des joueurs, récupérer des fichiers et interagir avec d’autres fonctionnalités PlayFab.

Prérequis

Avant de commencer, assurez-vous d’avoir :
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 du PFEntityHandle 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 :
🎉 Félicitations ! Vous avez effectué avec succès votre premier appel d’API de service PlayFab à l’aide du SDK unifié.

Comprendre le modèle d’appel d’API

Tous les appels d’API de service PlayFab suivent un modèle similaire :
  1. Préparer la requête : créez et renseignez une structure de requête
  2. Lancer l’appel asynchrone : appelez la fonction *Async
  3. Attendre la fin : utilisez XAsyncGetStatus pour attendre la fin de l’opération
  4. Obtenir la taille du résultat : appelez *GetResultSize pour déterminer la taille de mémoire tampon nécessaire
  5. Récupérer le résultat : appelez *GetResult pour obtenir les données proprement dites
Ce modèle s’applique à toutes les API de service PlayFab, ce qui facilite l’utilisation des différents services une fois les bases comprises.

É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

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.

Documentation de référence

Dernière modification le 8 octobre 2026