Configuration de l'authentification PlayFab avec Facebook et Unity

​

Configuration requise

• Unity 5+ et un projet créé.
• Un compte Facebook pour les tests.
• Le Facebook SDK importé dans le projet.
• Un titre PlayFab inscrit.
• Le SDK PlayFab 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.

​

Implémentation

​

Inscription d’une application Facebook

1. Placez le pointeur de la souris sur le bouton My Apps.
2. Sélectionnez Add a New App, comme illustré ci-dessous.

1. Entrez un nom pour votre Application.
2. Entrez une adresse Contact Email.

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.

1. Repérez votre App dans la liste.
2. Vérifiez qu’un User Token lui est attribué.

1. Dans votre page Application Manager, accédez à + Add Products.
2. Repérez l’entrée Facebook Login et sélectionnez Get Started.

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

1. Sélectionnez Facebook dans le menu Fichier.
2. Sélectionnez ensuite Edit Settings.

• Entrez votre Application ID dans le champ correspondant, comme illustré ci-dessous.

​

Script d’authentification simple

1. Créez un script nommé PlayfabFacebookAuthExample.cs.
2. Ajoutez-le au Game Object, comme illustré ci-dessous.

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

• 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).

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.

• Renseignez votre Package ID.
• Sélectionnez Save (le bouton Save est masqué dans le coin inférieur droit de la page).

• 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

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

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.

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

• 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

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