Configuration de l'authentification PlayFab avec Facebook et Unity

​

Exigences

• Unity 5+ et un projet créé.
• Un compte Facebook pour les tests.
• Le Facebook SDK importé dans le projet.
• Un titre PlayFab inscrit.
• Le PlayFab SDK importé dans le projet avec une référence de titre configurée.
• Une bonne connaissance des principes de base et meilleures pratiques de connexion.

​

Implémentation

​

Inscription d’une application Facebook

1. Déplacez votre souris sur le bouton My Apps.
2. Sélectionnez Add a New App, comme illustré dans l’image ci-dessous.

1. Entrez un nom pour votre Application.
2. Entrez une adresse courriel de contact (Contact Email).

1. Accédez à l’onglet Settings.
2. Passez ensuite au sous-onglet Basic.
3. Repérez votre Application ID.
   • Copiez-le dans un endroit sûr et 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. Sur 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é dans l’image suivante.

​

Script d’authentification simple

1. Créez un script nommé PlayfabFacebookAuthExample.cs.
2. Ajoutez-le au Game Object, comme illustré dans l’image 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îtra dans votre vue de jeu.
2. Entrez le User Token.
3. Sélectionnez le bouton Send Success, comme illustré dans l’image suivante.

• Vérifiez la sortie de la console. Elle devrait afficher nos instructions de débogage, comme illustré dans l’image ci-dessous.
• Si vous ne voyez aucune erreur, cela signifie que 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.

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

• L’application devrait vous accueillir avec une page de connexion Facebook.
• Une fois connecté, observez le message à l’écran à mesure qu’il change.
• Enfin, un message devrait vous indiquer que l’authentification dans PlayFab a réussi. 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.
• Assurez-vous de 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.

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

• Générez ensuite l’application comme d’habitude.
• Une fois cela fait, ouvrez le projet à l’aide de XCode.

• Sélectionnez le projet pour ouvrir les Project Settings.
• Vérifiez que le Bundle ID correspond à votre Package ID unique.

• Assurez-vous de sélectionner le bon appareil.

• Et sélectionnez la bonne Identity Team.

• Une fois démarrée, l’application vous permettra de vous connecter à Facebook à l’aide du navigateur Web.
• Une fois cela fait, l’authentification PlayFab sera appelée et un message en indiquera le résultat.

​

Vérification dans PlayFab Game Manager

• Accédez au tableau de bord.
• Consultez le panneau PlayStream Debugger pour vérifier les événements les plus récents. Vous devriez voir l’événement d’authentification Facebook, comme illustré dans l’exemple suivant.