Einrichten der PlayFab-Authentifizierung mit Facebook und Unity

Dieses Tutorial führt Sie durch ein Beispiel für die PlayFab-Authentifizierung mit Facebook und Unity.

Voraussetzungen

• Unity 5+ und ein erstelltes Projekt.
• Facebook Konto für Tests.
• Facebook SDK in das Projekt importiert.
• Registrierter PlayFab-Titel .
• PlayFab SDK , das mit einem konfigurierten Titelverweis in das Projekt importiert wurde.
• Vertrautheit mit Anmeldegrundlagen und bewährten Methoden.

Implementierung

Registrieren einer Facebook-Anwendung

Navigieren Sie zunächst zum Facebook Developer Portal:

1. Bewegen Sie die Maus über die schaltfläche Meine Apps.
2. Wählen Sie Neue App hinzufügen aus, wie in der abbildung unten gezeigt.

Ein neues Anwendungsfenster wird geöffnet.

1. Geben Sie einen Namen für Ihre Anwendung ein.
2. Geben Sie eine Kontakt-Email ein.

Notiz

Stellen Sie sicher, dass Sie Ihren eigenen eindeutigenAnwendungsnamen und Email haben, wie in der folgenden Abbildung dargestellt.

1. Navigieren Sie zur Registerkarte Einstellungen .
2. Wechseln Sie dann zur Unterregisterkarte Basic .
3. Suchen Sie Ihre Anwendungs-ID.
   • Kopieren Sie es an einen sicheren Ort, der leicht zugänglich ist. Wir verwenden es später zum Einrichten des Facebook SDK.

Navigieren Sie zum Facebook Zugriffstokentool.

1. Suchen Sie Ihre App in der Liste.
2. Vergewissern Sie sich, dass ihm ein Benutzertoken zugewiesen ist.

Notiz

Wenn Sie nicht über ein zugewiesenes Benutzertoken verfügen, fordern Sie mithilfe der Schaltfläche rechts neben dem Bildschirm ein Token an. Lesen Sie diese Seite, wenn Sie ein neues Benutzertoken benötigen. Wenn die Autorisierung während des Tests auf einem PC fehlschlägt, kann der Tokenablauf der wahrscheinlichste Grund sein. Aktualisieren Sie die Seite, um ein neues Benutzertoken zu erhalten, und testen Sie sie erneut.

1. Navigieren Sie auf der Seite Anwendungs-Manager zu + Produkte hinzufügen.
2. Suchen Sie den Eintrag Facebook Anmeldung, und wählen Sie Erste Schritte aus.

Eine Seite mit den Produkteinstellungen für die Anmeldung sollte geöffnet werden.

1. Stellen Sie sicher, dass die Seite Anmeldeprodukteinstellungen geöffnet ist.
2. Vergewissern Sie sich, dass sowohl Client-OAuth als auch Web-OAuth aktiviert sind.

Einrichten Facebook SDK

Öffnen Sie Ihr Unity-Projekt:

1. Wählen Sie im Dateimenü Facebook aus.
2. Wählen Sie dann Einstellungen bearbeiten aus.

Im Fenster Inspector wird die aktuelle Facebook SDK-Konfiguration angezeigt.

• Geben Sie Ihre Anwendungs-ID in das entsprechende Feld ein, wie in der folgenden Abbildung dargestellt.

Einfaches Authentifizierungsskript

Erstellen Sie ein neues Game-Objekt, und benennen Sie es in PlayfabFacebookAuthExample um, wie in der folgenden Abbildung dargestellt.

1. Erstellen Sie ein Skript namens PlayfabFacebookAuthExample.cs.
2. Fügen Sie es dem Game-Objekt hinzu, wie in der abbildung unten gezeigt.

Platzieren Sie PlayfabFacebookAuthExample.cs darin den folgenden Code.

// 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);
    }
}

Testen

Ausführen der Anwendung im Editor

1. Wählen Sie die Schaltfläche Wiedergeben aus. Sobald Facebook initialisiert wurde (und ein Authentifizierungsaufruf erfolgt ist), wird in der Spielansicht ein dialogfeld Facebook Authentifizierung angezeigt.
2. Geben Sie das Benutzertoken ein.
3. Wählen Sie die Schaltfläche Send Success (Erfolg senden ) aus, wie in der folgenden Abbildung dargestellt.

• Überprüfen Sie die Konsolenausgabe. Die Debuganweisungen sollten wie in der folgenden Abbildung dargestellt gerendert werden.
• Wenn keine Fehler angezeigt werden, bedeutet dies, dass die Authentifizierung erfolgreich war.

Ausführen der Anwendung unter Android

Bevor Sie die Anwendung unter Android starten, müssen Sie zusätzliche Konfigurationsschritte ausführen:

• Zunächst müssen Sie sicherstellen, dass die Android-Plattform ausgewählt und die eindeutige Paket-ID festgelegt ist (wie im folgenden Beispiel gezeigt).

Notiz

Stellen Sie sicher, dass Sie Ihre eigene eindeutigePaket-ID erstellen.

Tipp

Optionaler Schritt: Installieren Sie Open SSL , und fügen Sie es der Umgebungsvariable PATH hinzu. Wenn sie fehlt, erzeugt Unity während des Builds einen harmlosen Fehler. Dieser Fehler beendet weder den Build noch wirkt sich auf die Ausführung aus.

Als Nächstes gehen Sie in Ihrer Facebook-Anwendungskonsole wie folgt vor:

1. Navigieren Sie zu Grundeinstellungen .
2. Wählen Sie + Plattform hinzufügen aus, wie im folgenden Beispiel gezeigt.

• Wählen Sie dann Android aus der Liste der verfügbaren Plattformen aus.

Ein Panel mit plattformspezifischen Einstellungen wird angezeigt.

• Geben Sie Ihre Paket-ID ein.
• Wählen Sie Speichern aus (die Schaltfläche Speichern ist in der unteren rechten Ecke der Seite ausgeblendet).

Erstellen Sie die Anwendung, und führen Sie sie normal auf Ihrem Android-Gerät aus.

• Die Anwendung sollte Sie mit einer Facebook Anmeldeseite begrüßen.
• Nachdem Sie sich angemeldet haben, watch die Nachricht auf dem Bildschirm, wenn sie sich ändert.
• Schließlich sollte eine Meldung angezeigt werden, die angibt, dass die Authentifizierung in PlayFab erfolgreich war. Das gesamte Verfahren wird im folgenden Beispiel veranschaulicht.

Ausführen der Anwendung unter iOS

Bevor Sie die Anwendung unter iOS starten, müssen Sie zusätzliche Konfigurationsschritte ausführen.

• Stellen Sie zunächst sicher, dass Sie die iOS-Plattform ausgewählt haben.
• Legen Sie dann eine eindeutige Bundle-ID fest, wie im folgenden Beispiel angegeben.
• Stellen Sie sicher, dass Sie Ihre eigene eindeutigePaket-ID erstellen.

Als Nächstes gehen Sie in Ihrer Facebook-Anwendungskonsole wie folgt vor:

1. Navigieren Sie zu Grundeinstellungen .
2. Wählen Sie + Plattform hinzufügen aus, wie im folgenden Beispiel gezeigt.

• Wählen Sie in der Liste der verfügbaren Plattformen iOS aus.

Ein Panel mit plattformspezifischen Einstellungen wird angezeigt.

• Geben Sie Ihre Paket-ID ein.
• Wählen Sie die Schaltfläche Speichern aus (die Schaltfläche Speichern ist in der unteren rechten Ecke der Seite ausgeblendet).

• Erstellen Sie als Nächstes die Anwendung wie gewohnt.
• Öffnen Sie anschließend das Projekt mit XCode.

• Wählen Sie das Projekt aus, um Projekteinstellungen zu öffnen.
• Vergewissern Sie sich, dass die Bundle-ID mit Ihrer eindeutigen Paket-ID übereinstimmt.

• Stellen Sie sicher, dass Sie das richtige Gerät auswählen.

• Wählen Sie dann das richtige Identitätsteam aus.

Führen Sie die Anwendung schließlich wie gewohnt aus.

• Nach dem Start können Sie sich mit der Anwendung über den Webbrowser bei Facebook anmelden.
• Anschließend wird die PlayFab-Authentifizierung aufgerufen, und das Ergebnis wird in einer Meldung angezeigt.

Überprüfen des PlayFab-Spiel-Managers

Öffnen Sie Ihren PlayFab-Titel im Game Manager.

• Navigieren Sie zum Dashboard.
• Überprüfen Sie im Bereich PlayStream-Debugger nach den neuesten Ereignissen. Das Facebook-Authentifizierungsereignis sollte wie im folgenden Beispiel angezeigt werden.

An diesem Punkt haben Sie Facebook Authentication für PlayFab erfolgreich integriert.