Passer au contenu principal

Démarrage rapide : bibliothèque cliente PlayFab pour C# dans Unity

Prenez en main la bibliothèque cliente PlayFab pour C# dans Unity. Suivez les étapes pour installer le package et essayer l’exemple de code pour une tâche de base. Ce démarrage rapide vous aide à effectuer votre premier appel d’API PlayFab dans le moteur Unity.

Configuration requise

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

Télécharger et installer le SDK PlayFab

Utilisez le package PlayFab Editor Extensions pour installer le SDK, ou installez directement le SDK. Les PlayFab Editor Extensions sont un plug-in Unity autonome qui simplifie l’installation du SDK et la configuration de certains paramètres PlayFab pour votre titre. Pour plus d’informations sur l’installation du SDK sans utiliser les PlayFab Editor Extensions, consultez Installation du SDK PlayFab sans les Editor Extensions pour Unity.
  1. Téléchargez le package d’assets PlayFab Unity Editor Extensions.
  2. Ouvrez votre projet Unity.
  3. Accédez à l’emplacement du fichier téléchargé et double-cliquez sur le fichier PlayFabEditorExtensions.UnityPackage pour ouvrir la boîte de dialogue Import Unity Package dans l’éditeur Unity. Importer le package d'assets Unity
  4. Pour importer les PlayFab Unity Editor Extensions dans votre projet, sélectionnez Import.
  5. Une fois l’importation terminée, le panneau PlayFab Unity Editor Extensions devrait s’ouvrir automatiquement et afficher la boîte de dialogue d’installation du SDK.
Si le panneau ne s’est pas ouvert, ou si vous le fermez et souhaitez le rouvrir, sélectionnez Window > PlayFab > Editor Extensions
Installer le SDK PlayFab 6. Sélectionnez Install PlayFab SDK pour importer automatiquement le SDK dans votre projet ou mettre à niveau la version actuellement installée.

Définir les paramètres de votre titre

Avant de pouvoir effectuer un appel d’API, vous devez créer un PlayFabSharedSettings.asset et spécifier l’ID du titre qui recevra l’appel. Pour définir l’ID de titre :
  1. Sélectionnez PlayFab > MakePlayFabSharedSettings, ce qui devrait créer l’asset de paramètres et l’ouvrir dans le panneau Inspector.
  2. Définissez votre Title ID dans l’inspecteur. Paramètre Title ID de PlayFab
  3. Désormais, vous pouvez à tout moment afficher et modifier l’ID de titre actuel depuis l’onglet Settings du panneau Editor Extensions.
La Developer Secret Key n’est pas définie par défaut. Si vous créez une build serveur, veillez à fournir la clé secrète dans PlayFabSharedSettings.asset. Paramètre Developer Secret Key de PlayFab La Developer Secret Key est automatiquement définie sur la clé secrète par défaut du titre. Pour plus d’informations sur les clés secrètes, consultez Gestion des clés secrètes. Sinon, assurez-vous que la clé secrète n’est pas définie lors de la génération de votre client de jeu. Pour plus d’informations sur les clés secrètes, consultez Gestion des clés secrètes.
Les extensions vous permettent de personnaliser le transport HTTP utilisé pour envoyer les requêtes à PlayFab. La valeur par défaut recommandée est Unity Web Request. D’autres options existent pour assurer la compatibilité avec des versions plus anciennes du moteur ou des implémentations HTTP propres au jeu.

Effectuer votre premier appel d’API

Cette partie du guide présente les étapes minimales nécessaires pour effectuer votre premier appel d’API PlayFab. Cet exemple ne fournit ni interface graphique ni retour à l’écran. La confirmation s’affiche dans le journal de la console.
  1. Si votre projet Unity ne contient pas encore de dossier Scripts (les modèles HDRP et LWRP/URP en ont un par défaut), cliquez avec le bouton droit sur le dossier Assets dans le panneau Project et sélectionnez Create > Folder.
  2. Dans la fenêtre Assets, nommez le dossier Scripts.
  3. Cliquez avec le bouton droit sur le dossier Scripts et sélectionnez Create > C# Script.
  4. Nommez le script PlayFabLogin.
  5. Double-cliquez sur le fichier pour l’ouvrir dans un éditeur de code.
  6. Dans votre éditeur de code, remplacez le contenu de PlayFabLogin.cs par le code fourni et enregistrez le fichier.
Le code fourni n’est pas destiné aux titres mobiles. Il ne s’agit que d’un exemple qui montre comment se connecter avec un CustomID. Pour implémenter la connexion d’un titre mobile, utilisez
LoginWithAndroidDeviceID, LoginWithIOSDeviceID ou une forme de connexion sociale telle que LoginWithFacebook. 7. Dans le panneau Hierarchy, cliquez avec le bouton droit sur votre scène, puis sélectionnez Create Empty (ou Game Object > Create Empty dans les anciennes versions d’Unity). 8. Sélectionnez le nouveau Game Object et, dans le panneau Inspector, sélectionnez Add Component. 9. Dans le menu déroulant des composants, sélectionnez Scripts > PlayFabLogin. Pour plus d’informations sur la création et l’utilisation de scripts dans l’éditeur Unity, consultez Création et utilisation de scripts dans la documentation Unity.

Terminer et exécuter

Vous êtes maintenant prêt à tester cet exemple.
  • Veillez à enregistrer tous les fichiers et à revenir à l’éditeur Unity
  • Appuyez sur le bouton Play en haut de l’éditeur
Le message suivant devrait s’afficher dans votre panneau Console Unity. Journal de la console du premier appel d'API
Vous pouvez également vous connecter à PlayFab, accéder au titre dans Game Manager et sélectionner l’onglet PlayStream Monitor. Chaque fois que vous quittez le titre Unity en cours d’exécution, un événement est transmis, que vous pouvez voir et confirmer dans le PlayStream Monitor.
Pour obtenir la liste de tous les appels d’API client disponibles, consultez Références de l’API PlayFab.

Étapes suivantes

Ce démarrage rapide présente une procédure simplifiée d’authentification d’un utilisateur. Pour plus d’informations sur l’authentification des utilisateurs, consultez Principes de base et bonnes pratiques de connexion. Découvrez comment lier un compte à plusieurs appareils et mécanismes de connexion : Démarrage rapide de la liaison de comptes.
Dernière modification le 8 octobre 2026