> ## 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.
# Configuration de l'authentification PlayFab avec Facebook et Unity
> Tutoriel pas à pas pour intégrer la connexion Facebook dans un projet Unity avec le SDK PlayFab, couvrant la configuration de l'application Facebook et le code d'authentification des joueurs.
Ce tutoriel vous guide à travers un exemple d'authentification PlayFab avec Facebook et Unity.
## Configuration requise
* [Unity 5+](https://unity3d.com/) et un projet créé.
* Un [compte Facebook](https://www.facebook.com/) pour les tests.
* Le [Facebook SDK](https://developers.facebook.com/docs/unity/) importé dans le projet.
* Un titre [PlayFab](https://developer.playfab.com/) inscrit.
* Le [SDK PlayFab](https://aka.ms/playfabunitysdkdownload) importé dans le projet avec une référence de titre configurée.
* Une bonne connaissance des [principes de base et bonnes pratiques de connexion](/fr/services/playfab/identity/player-identity/login/login-basics-best-practices).
## Implémentation
### Inscription d'une application Facebook
Commencez par accéder au [portail des développeurs Facebook](https://developers.facebook.com/) :
1. Placez le pointeur de la souris sur le bouton **My Apps**.
2. Sélectionnez **Add a New App**, comme illustré ci-dessous.
Une nouvelle fenêtre contextuelle **Application** s'ouvre.
1. Entrez un nom pour votre **Application**.
2. Entrez une adresse **Contact Email**.
Veillez à choisir votre propre **Application Name** *unique* et votre propre **Email**, comme illustré ci-dessous.
1. Accédez à l'onglet **Settings**.
2. Passez ensuite au sous-onglet **Basic**.
3. Repérez votre **Application ID**.
* Copiez-le en lieu sûr, à un endroit facilement accessible.
Nous l'utiliserons plus tard pour configurer le Facebook SDK.
Accédez au [Facebook Access Token Tool](https://developers.facebook.com/tools/accesstoken/).
1. Repérez votre **App** dans la liste.
2. Vérifiez qu'un **User Token** lui est attribué.
Si aucun jeton utilisateur ne vous est attribué, demandez-en un à l'aide du bouton situé à droite de votre écran. Consultez cette page chaque fois que vous avez besoin d'un nouveau jeton utilisateur. Si l'autorisation échoue lors des tests sur PC, l'expiration du jeton en est probablement la cause. Actualisez la page pour obtenir un nouveau jeton utilisateur et testez à nouveau.
1. Dans votre page **Application Manager**, accédez à **+ Add Products**.
2. Repérez l'entrée **Facebook Login** et sélectionnez **Get Started**.
Une page contenant les paramètres du produit **Login** doit s'ouvrir.
1. Assurez-vous que la page **Settings** du produit **Login** est ouverte.
2. Vérifiez que **Client OAuth** et **Web OAuth** sont tous deux activés.
### Configuration du Facebook SDK
Ouvrez votre **projet Unity** :
1. Sélectionnez **Facebook** dans le menu Fichier.
2. Sélectionnez ensuite **Edit Settings**.
La fenêtre **Inspector** affiche la configuration actuelle du **Facebook SDK**.
* Entrez votre **Application ID** dans le champ correspondant, comme illustré ci-dessous.
### Script d'authentification simple
Créez un nouveau **Game Object** et renommez-le **PlayfabFacebookAuthExample**, comme illustré ci-dessous.
1. Créez un script nommé **PlayfabFacebookAuthExample.cs**.
2. Ajoutez-le au **Game Object**, comme illustré ci-dessous.
Dans `PlayfabFacebookAuthExample.cs`, placez le code suivant.
```csharp theme={null}
// Import statements introduce all the necessary classes for this example.
using Facebook.Unity;
using PlayFab;
using PlayFab.ClientModels;
using UnityEngine;
using LoginResult = PlayFab.ClientModels.LoginResult;
public class PlayfabFacebookAuthExample : MonoBehaviour
{
// holds the latest message to be displayed on the screen
private string _message;
public void Start()
{
SetMessage("Initializing Facebook..."); // logs the given message and displays it on the screen using OnGUI method
// This call is required before any other calls to the Facebook API. We pass in the callback to be invoked once initialization is finished
FB.Init(OnFacebookInitialized);
}
private void OnFacebookInitialized()
{
SetMessage("Logging into Facebook...");
// Once Facebook SDK is initialized, if we are logged in, we log out to demonstrate the entire authentication cycle.
if (FB.IsLoggedIn)
FB.LogOut();
// We invoke basic login procedure and pass in the callback to process the result
FB.LogInWithReadPermissions(null, OnFacebookLoggedIn);
}
private void OnFacebookLoggedIn(ILoginResult result)
{
// If result has no errors, it means we have authenticated in Facebook successfully
if (result == null || string.IsNullOrEmpty(result.Error))
{
SetMessage("Facebook Auth Complete! Access Token: " + AccessToken.CurrentAccessToken.TokenString + "\nLogging into PlayFab...");
/*
* We proceed with making a call to PlayFab API. We pass in current Facebook AccessToken and let it create
* and account using CreateAccount flag set to true. We also pass the callback for Success and Failure results
*/
PlayFabClientAPI.LoginWithFacebook(new LoginWithFacebookRequest { CreateAccount = true, AccessToken = AccessToken.CurrentAccessToken.TokenString},
OnPlayfabFacebookAuthComplete, OnPlayfabFacebookAuthFailed);
}
else
{
// If Facebook authentication failed, we stop the cycle with the message
SetMessage("Facebook Auth Failed: " + result.Error + "\n" + result.RawResult, true);
}
}
// When processing both results, we just set the message, explaining what's going on.
private void OnPlayfabFacebookAuthComplete(LoginResult result)
{
SetMessage("PlayFab Facebook Auth Complete. Session ticket: " + result.SessionTicket);
}
private void OnPlayfabFacebookAuthFailed(PlayFabError error)
{
SetMessage("PlayFab Facebook Auth Failed: " + error.GenerateErrorReport(), true);
}
public void SetMessage(string message, bool error = false)
{
_message = message;
if (error)
Debug.LogError(_message);
else
Debug.Log(_message);
}
public void OnGUI()
{
var style = new GUIStyle { fontSize = 40, normal = new GUIStyleState { textColor = Color.white }, alignment = TextAnchor.MiddleCenter, wordWrap = true };
var area = new Rect(0,0,Screen.width,Screen.height);
GUI.Label(area, _message,style);
}
}
```
## Test
### Exécution de l'application dans l'éditeur
1. Sélectionnez le bouton **Play**. Une fois **Facebook** initialisé (et un appel d'authentification effectué), une boîte de dialogue d'authentification **Facebook** apparaît dans la vue de votre jeu.
2. Entrez le **User Token**.
3. Sélectionnez le bouton **Send Success**, comme illustré ci-dessous.
* Vérifiez la sortie de la console. Elle doit afficher nos instructions de débogage, comme illustré ci-dessous.
* Si aucune erreur ne s'affiche, l'authentification a réussi.
### Exécution de l'application sur Android
Avant de lancer l'application sur Android, vous devez effectuer des étapes de configuration supplémentaires :
* Tout d'abord, vous devez vous assurer que la plateforme Android est sélectionnée et que le **Package ID** unique est défini (comme indiqué dans l'exemple ci-dessous).
Veillez à créer votre propre **Package ID** *unique*.
**Étape facultative** : installez [Open SSL](https://wiki.openssl.org/index.php/Binaries) et ajoutez-le à la variable d'environnement **PATH**. S'il est absent, Unity génère une erreur sans conséquence pendant la génération. Cette erreur n'arrête pas la génération et n'affecte pas l'exécution.
Ensuite, dans la console de votre **application Facebook** :
1. Accédez aux paramètres **Basic**.
2. Sélectionnez **+ Add Platform**, comme indiqué dans l'exemple ci-dessous.
* Sélectionnez ensuite **Android** dans la liste des plateformes disponibles.
Un panneau contenant les paramètres propres à la plateforme apparaît.
* Renseignez votre **Package ID**.
* Sélectionnez **Save** (le bouton **Save** est masqué dans le coin inférieur droit de la page).
Générez et exécutez l'application normalement sur votre appareil Android.
* L'application doit vous accueillir avec une page de connexion Facebook.
* Une fois connecté, observez le message à l'écran au fur et à mesure qu'il change.
* Enfin, un message indiquant la réussite de l'authentification dans PlayFab doit s'afficher. L'ensemble de la procédure est illustré dans l'exemple ci-dessous.
### Exécution de l'application sur iOS
Avant de lancer l'application sur iOS, vous devez effectuer des étapes de configuration supplémentaires.
* Tout d'abord, assurez-vous que la plateforme **iOS** est sélectionnée.
* Définissez ensuite un **Bundle ID** unique, comme indiqué dans l'exemple ci-dessous.
* Veillez à créer votre propre **Package ID** *unique*.
Ensuite, dans votre **Facebook Application Console** :
1. Accédez aux paramètres **Basic**.
2. Sélectionnez **+ Add Platform**, comme indiqué dans l'exemple ci-dessous.
* Sélectionnez **iOS** dans la liste des plateformes disponibles.
Un panneau contenant les paramètres propres à la plateforme apparaît.
* Renseignez votre **Package ID**.
* Sélectionnez le bouton **Save** (le bouton **Save** est masqué dans le coin inférieur droit de la page).
* Générez ensuite l'application comme d'habitude.
* Une fois cette opération terminée, ouvrez le **projet** à l'aide de **XCode**.
* Sélectionnez le **projet** pour ouvrir **Project Settings**.
* Vérifiez que le **Bundle ID** correspond à votre **Package ID** unique.
* Veillez à sélectionner le bon appareil.
* Et sélectionnez la bonne **Identity Team**.
Enfin, exécutez l'application normalement.
* Une fois démarrée, l'application vous permet de vous connecter à Facebook à l'aide du navigateur web.
* Une fois cette opération terminée, l'authentification PlayFab est appelée et un message indique le résultat.
### Vérification via PlayFab Game Manager
Ouvrez votre titre PlayFab dans Game Manager.
* Accédez au tableau de bord.
* Consultez le panneau **PlayStream Debugger** pour vérifier les derniers événements. L'événement d'authentification Facebook doit s'afficher, comme dans l'exemple suivant.
À ce stade, vous avez correctement intégré l'authentification Facebook pour PlayFab.
## Related topics
- [Authentification spécifique à la plateforme](/fr/services/playfab/identity/player-identity/platform-specific-authentication/index.md)
- [Configuration de l'authentification PlayFab avec Facebook et HTML5](/fr/services/playfab/identity/player-identity/platform-specific-authentication/facebook-html5.md)
- [Configuration de l'authentification PlayFab avec Kongregate et Unity](/fr/services/playfab/identity/player-identity/platform-specific-authentication/kongregate-unity.md)
- [Configuration de l'authentification PlayFab avec Steam et Unity](/fr/services/playfab/identity/player-identity/platform-specific-authentication/steam-unity.md)
- [Configuration de l'authentification PlayFab avec Google et HTML5](/fr/services/playfab/identity/player-identity/platform-specific-authentication/google-html5.md)