Prérequis
Avant de commencer, suivez les étapes de configuration de Configuration du démarrage rapide pour configurer votre environnement de développement et votre projet.Ce que vous allez accomplir
À la fin de ce démarrage rapide, vous aurez :- Configuré le SDK unifié PlayFab dans votre projet Windows
- Initialisé le SDK avec votre ID de titre
- Authentifié un joueur à l’aide de XBOX ou de Steam
- Obtenu un handle d’entité pour effectuer des appels d’API
- Nettoyé correctement les ressources
Dans ce démarrage rapide
Étape 1. Initialiser le SDK
Inclure les en-têtes requis
Commencez par inclure les en-têtes PlayFab et XBOX Game Runtime nécessaires dans votre projet :Initialiser les services XBOX Gaming Runtime
Le SDK unifié PlayFab nécessite XBOX Game Runtime. Initialisez-le d’abord :Initialiser PlayFab Core
Initialisez le SDK PlayFab et créez un handle de configuration de service. RemplacezABCDEF par votre véritable ID de titre PlayFab :
Étape 2. Authentifier un joueur
PlayFab exige l’authentification du joueur avant tout appel d’API. Le SDK fournit plusieurs méthodes d’authentification en fonction de votre plateforme et de vos besoins.Choisir votre méthode d’authentification
Option A : connexion avec XBOX (recommandée pour Windows/XBOX)
UtilisezPFAuthenticationLoginWithXUserAsync pour vous connecter avec un compte d’utilisateur XBOX. C’est la méthode recommandée pour les applications Windows et XBOX.
Option B : connexion avec Steam
Pour les jeux intégrés à Steam, utilisezPFAuthenticationLoginWithSteamAsync avec un ticket d’authentification Steam.
Le
PFEntityHandle renvoyé lors de la connexion est requis pour tous les appels d’API PlayFab ultérieurs. Gardez ce handle disponible pendant toute la durée de vie de votre application.Étape 3. Nettoyer les ressources
Lorsque votre application s’arrête, nettoyez correctement toutes les ressources pour éviter les fuites de mémoire et garantir un arrêt propre :Nettoyez toujours les ressources dans l’ordre inverse de l’initialisation afin de garantir un arrêt correct.
Étapes suivantes
Maintenant que vous avez initialisé le SDK et authentifié un joueur, vous êtes prêt à appeler les services PlayFab :Effectuer votre premier appel d’API
- Appel des services PlayFab : découvrez comment appeler les API PlayFab pour gérer les données des joueurs et utiliser les services de jeu
Concepts de base
- 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
Authentification avancée
- Authentification multiplateforme : prenez en charge plusieurs fournisseurs d’authentification
- Authentification par ID personnalisé : utilisez votre propre système d’authentification
- Liaison de comptes : liez plusieurs méthodes d’authentification à un même compte
