> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Démarrage rapide Unity

> Installez le SDK PlayFab pour Unity et effectuez votre premier appel d'API client PlayFab en C# depuis un projet Unity à l'aide de l'éditeur et de la bibliothèque cliente.

# 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

* Un [compte de développeur PlayFab](https://developer.playfab.com).
* Une copie installée de l'éditeur Unity. Pour installer Unity pour un usage personnel au moyen d'Unity Hub, ou Unity+ pour un usage professionnel, consultez [Télécharger Unity](https://unity.com/download).

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

* Un projet Unity de l'un des types suivants :
  * Un tout nouveau projet. Pour plus d'informations, consultez [Démarrer Unity pour la première fois](https://docs.unity3d.com/Manual/get-started-with-unity.html).
  * Un projet de tutoriel guidé. Pour plus d'informations, consultez [Bien démarrer avec Unity](https://learn.unity.com/).
  * Un projet existant.
* Le SDK PlayFab pour Unity.

## 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](/fr-CA/services/playfab/sdks/unity3d/installing-unity3d-sdk#télécharger-et-installer-uniquement-le-sdk).

1. Téléchargez le [package d'assets PlayFab Unity Editor Extensions](https://aka.ms/PlayFabUnityEdEx).
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.

   <img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/playfab/sdks/unity3d/import-uedex.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=7fe7482c3981c4c09469872bc7ee6bc1" alt="Importer le package d'assets Unity" width="352" height="582" data-path="images/playfab/sdks/unity3d/import-uedex.png" />
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.

<Note>
  Si le panneau ne s'est pas ouvert, ou si vous le fermez et souhaitez le rouvrir, sélectionnez **Window** > **PlayFab** > **Editor Extensions**
</Note>

<img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/playfab/sdks/unity3d/install-sdk.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=ef1dddd1a1f2e66865c1ffae2f972fbe" alt="Installer le SDK PlayFab" width="395" height="384" data-path="images/playfab/sdks/unity3d/install-sdk.png" />

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.

   <img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/playfab/sdks/unity3d/playfab-shared-settings-title-id.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=6d2534c5573758d21d3f860adcab8f65" alt="Paramètre Title ID de PlayFab" width="1018" height="510" data-path="images/playfab/sdks/unity3d/playfab-shared-settings-title-id.png" />

3. Maintenant, 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, assurez-vous de fournir la clé secrète dans **PlayFabSharedSettings.asset**.

<img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/playfab/sdks/unity3d/playfab-shared-settings-secret-key.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=35f6f7c6dcd9094e0699bfa967b8ec77" alt="Paramètre Developer Secret Key de PlayFab" width="1018" height="510" data-path="images/playfab/sdks/unity3d/playfab-shared-settings-secret-key.png" />

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](/fr-CA/services/playfab/live-service-management/gamemanager/secret-key-management).

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](/fr-CA/services/playfab/live-service-management/gamemanager/secret-key-management).

<Note>
  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.
</Note>

## 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.

   ```csharp theme={null}
   using PlayFab;
   using PlayFab.ClientModels;
   using UnityEngine;

   public class PlayFabLogin : MonoBehaviour
   {
       public void Start()
       {
           if (string.IsNullOrEmpty(PlayFabSettings.staticSettings.TitleId)){
               /*
               Please change the titleId below to your own titleId from PlayFab Game Manager.
               If you have already set the value in the Editor Extensions, this can be skipped.
               */
               PlayFabSettings.staticSettings.TitleId = "42";
           }
           var request = new LoginWithCustomIDRequest { CustomId = "GettingStartedGuide", CreateAccount = true};
           PlayFabClientAPI.LoginWithCustomID(request, OnLoginSuccess, OnLoginFailure);
       }

       private void OnLoginSuccess(LoginResult result)
       {
           Debug.Log("Congratulations, you made your first successful API call!");
       }

       private void OnLoginFailure(PlayFabError error)
       {
           Debug.LogWarning("Something went wrong with your first API call.  :(");
           Debug.LogError("Here's some debug information:");
           Debug.LogError(error.GenerateErrorReport());
       }
   }
   ```

<Info>
  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
</Info>

[LoginWithAndroidDeviceID](xref:titleid.playfabapi.com.client.authentication.loginwithandroiddeviceid), [LoginWithIOSDeviceID](xref:titleid.playfabapi.com.client.authentication.loginwithiosdeviceid) ou une forme de connexion sociale telle que [LoginWithFacebook](xref:titleid.playfabapi.com.client.authentication.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](https://docs.unity3d.com/Manual/CreatingAndUsingScripts.html) dans la documentation Unity.

## Terminer et exécuter

Vous êtes maintenant prêt à tester cet exemple.

* Assurez-vous d'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.

<img src="https://mintcdn.com/microsoft-4404708b/N3T1ucKV7zIMBudj/images/playfab/sdks/unity3d/first-call-log.png?fit=max&auto=format&n=N3T1ucKV7zIMBudj&q=85&s=7f898d9ade63a607072bd75daeebf12d" alt="Journal de la console du premier appel d'API" width="600" height="242" data-path="images/playfab/sdks/unity3d/first-call-log.png" />

<Tip>
  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.
</Tip>

Pour obtenir la liste de tous les appels d'API client disponibles, consultez [Références de l'API PlayFab](/fr-CA/services/playfab/api-references).

## É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 pratiques exemplaires de connexion](/fr-CA/services/playfab/identity/player-identity/login/login-basics-best-practices).

Découvrez comment lier un compte à plusieurs appareils et mécanismes de connexion : [Démarrage rapide de la liaison de comptes](/fr-CA/services/playfab/identity/player-identity/login/quickstart).


## Related topics

- [Démarrage rapide](/fr-CA/services/playfab/economy-monetization/economy-v2/quickstart.md)
- [Démarrage rapide des entités](/fr-CA/services/playfab/live-service-management/game-configuration/entities/quickstart.md)
- [Démarrage rapide de Photon](/fr-CA/services/playfab/live-service-management/service-gateway/add-ons/photon/quickstart.md)
- [Démarrage rapide de Party](/fr-CA/services/playfab/multiplayer/networking/quickstart.md)
- [Démarrage rapide du plugiciel Multiplayer pour Unity](/fr-CA/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/multiplayer-unity-plugin-quickstart.md)