Passer au contenu principal
Ce guide vous montre comment intégrer le SDK unifié PlayFab à votre projet Windows, initialiser le SDK et authentifier un joueur. C’est la base pour effectuer des appels d’API PlayFab.

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

  1. Initialiser le SDK
  2. Authentifier un joueur
  3. Nettoyer les ressources

É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. Remplacez ABCDEF par votre véritable ID de titre PlayFab :
Vous trouverez votre ID de titre dans le tableau de bord Game Manager, dans les paramètres de votre jeu.

É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)

Utilisez PFAuthenticationLoginWithXUserAsync 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, utilisez PFAuthenticationLoginWithSteamAsync 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

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

Résolution des problèmes

Problèmes courants et solutions :

Documentation de référence

Dernière modification le 8 octobre 2026