Schnellstart: PlayFab-Clientbibliothek für C# in Unity

Erste Schritte mit der PlayFab-Clientbibliothek für C# in Unity. Führen Sie die Schritte aus, um das Paket zu installieren und Beispielcode für eine einfache Aufgabe auszuprobieren.

In dieser Schnellstartanleitung können Sie Ihren ersten PlayFab-API-Aufruf in der Unity-Engine durchführen.

Voraussetzungen

• Ein PlayFab-Entwicklerkonto.
• Eine installierte Kopie des Unity-Editors. Informationen zum Installieren von Unity für den persönlichen Gebrauch über Unity Hub oder Unity+ für die professionelle Verwendung finden Sie unter Herunterladen von Unity.

  Notiz

  Das PlayFab Unity SDK unterstützt Unity-Editor Version 5.3 (veröffentlicht im Dezember 2015) und höher.

• Ein Unity-Projekt mit einem der folgenden Typen:
  • Ein brandneues Projekt. Weitere Informationen finden Sie unter Erstmaliges Starten von Unity.
  • Ein geführtes Tutorialprojekt. Weitere Informationen finden Sie unter Erste Schritte mit Unity.
  • Ein vorhandenes Projekt.
• Das PlayFab Unity SDK.

Herunterladen und Installieren des PlayFab SDK

Verwenden Sie das PlayFab-Editorerweiterungspaket, um das SDK zu installieren. Die PlayFab-Editor-Erweiterungen sind ein eigenständiges Unity-Plug-In, das die Installation des SDK und die Konfiguration der PlayFab-Einstellungen für Ihren Titel optimiert. Informationen zum Installieren des SDK ohne Die PlayFab-Editorerweiterungen finden Sie unter Installieren des PlayFab SDK für Unity.

1. Laden Sie das PlayFab Unity-Editor-Erweiterungsobjektpaket herunter.

2. Öffnen Sie Ihr Unity-Projekt.

3. Navigieren Sie zum Speicherort, an dem Sie die Datei heruntergeladen haben, und doppelklicken Sie auf die PlayFabEditorExtensions.UnityPackage Datei, um das Dialogfeld Unity-Paket importieren im Unity-Editor zu öffnen.

   

4. Wählen Sie Importieren aus, um die PlayFab Unity-Editor-Erweiterungen in Ihr Projekt zu importieren.

5. Wenn der Import abgeschlossen ist, sollte der Bereich "PlayFab Unity-Editorerweiterungen" automatisch geöffnet werden. Wenn Sie bereits ein PlayFab-Entwicklerkonto erstellt haben, wählen Sie den Link Anmelden aus, um sich mit Ihrem PlayFab-Benutzernamen und -Kennwort anzumelden.

   

   Notiz

   Wenn das Panel nicht geöffnet wurde oder Sie das Panel schließen und es erneut öffnen möchten, können Sie dazu Windows>PlayFab-Editorerweiterungen> auswählen.

6. Nach der Anmeldung zeigt die Erweiterung das SDK-Installationsdialogfeld an.

   

7. Wählen Sie PlayFab SDK installieren aus, um das SDK automatisch in Ihr Projekt zu importieren oder die aktuell installierte Version zu aktualisieren.

Festlegen der Titeleinstellungen

Bevor Sie einen API-Aufruf ausführen können, müssen Sie den Titel angeben, um den Aufruf in den PlayFab-Titeleinstellungen zu empfangen. So legen Sie den Titel fest:

1. Wählen Sie in den Editor-Erweiterungen die Option SET MY TITLE (MEINEN TITEL FESTLEGEN) aus.

   

2. Wählen Sie den Eintrag Studio aus, um das Dropdownmenü studio zu öffnen. Wählen Sie das Studio aus, das den Titel enthält, mit dem Sie eine Verbindung herstellen möchten.

3. Wählen Sie den Eintrag Titel-ID aus, um ein Dropdownmenü mit Titeln zu öffnen, die dem ausgewählten Studio zugeordnet sind.

Der geheime Entwicklerschlüssel wird automatisch auf den geheimen Standardschlüssel für den Titel festgelegt. Weitere Informationen zu geheimen Schlüsseln finden Sie unter Verwaltung geheimer Schlüssel.

[! HINWEIS] Mit den Erweiterungen können Sie den HTTP-Transport anpassen, der zum Senden von Anforderungen an PlayFab verwendet wird. Die empfohlene Standardeinstellung ist Unity Web Request. Es gibt weitere Optionen, um Kompatibilität mit älteren Engine-Versionen oder spielspezifischen HTTP-Implementierungen bereitzustellen.

Durchführen Ihres ersten API-Aufrufs

Dieser Teil des Leitfadens enthält die Mindestschritte für ihren ersten PlayFab-API-Aufruf. In diesem Beispiel wird keine GRAFISCHE Benutzeroberfläche oder Feedback auf dem Bildschirm bereitgestellt. Die Bestätigung wird im Konsolenprotokoll angezeigt.

1. Wenn Ihr Unity-Projekt noch nicht über einen Skriptordner verfügt (HDRP- und LWRP/URP-Vorlagen verfügen standardmäßig über einen Ordner), klicken Sie mit der rechten Maustaste auf den Ordner Assets im Projektbereich, und wählen SieOrdnererstellen> aus.

2. Geben Sie dem Ordner im Fenster Objekte den Namen Skripts.

3. Klicken Sie mit der rechten Maustaste auf den Ordner Skripts, und wählen Sie C#-Skript erstellen> aus.

4. Nennen Sie das Skript PlayFabLogin.

5. Doppelklicken Sie auf die Datei, um sie in einem Code-Editor zu öffnen.

6. Ersetzen Sie in Ihrem Code-Editor den Inhalt von PlayFabLogin.cs durch den bereitgestellten Code, und speichern Sie die Datei.

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

   Wichtig

   Der bereitgestellte Code ist nicht für die Verwendung mit mobilen Titeln vorgesehen. Dies ist nur ein Beispiel und zeigt, wie Sie sich mit einem CustomIDanmelden. Um die Anmeldung für einen mobilen Titel zu implementieren, verwenden Sie entweder LoginWithAndroidDeviceID, LoginWithIOSDeviceID oder eine Form von Social Media-Anmeldung wie LoginWithFacebook.

7. Klicken Sie im Hierarchiebereich mit der rechten Maustaste auf Ihre Szene, und wählen Sie dann Leer erstellen (oder Game Object>Create Empty in älteren Versionen von Unity) aus.

8. Wählen Sie das neue Spielobjekt aus, und wählen Sie im Bereich Inspector (Inspektor ) die Option Add Component (Komponente hinzufügen) aus.

9. Wählen Sie im Dropdownmenü der Komponente Skripts>PlayFabLogin aus.

Weitere Informationen zum Erstellen und Verwenden von Skripts im Unity-Editor finden Sie unter Erstellen und Verwenden von Skripts in der Unity-Dokumentation.

Fertig stellen und ausführen

Sie können dieses Beispiel jetzt testen.

• Achten Sie darauf, alle Dateien zu speichern und zum Unity-Editor zurückzukehren.
• Klicken Sie oben im Editor auf die Schaltfläche Wiedergabe .

Die folgende Meldung sollte im Unity-Konsolenbereich angezeigt werden.

Tipp

Alternativ können Sie sich bei PlayFab anmelden und im Game Manager zum Titel navigieren und die Registerkarte PlayStream-Monitor auswählen. Jedes Mal, wenn Sie den Fokus vom aktiv ausgeführten Unity-Titel wegwechseln, wird ein Ereignis übergeben, das Sie im PlayStream-Monitor sehen und bestätigen können.

Eine Liste aller verfügbaren Client-API-Aufrufe finden Sie unter PlayFab-API-Verweise.

Nächste Schritte

In dieser Schnellstartanleitung wird ein vereinfachtes Verfahren zum Authentifizieren eines Benutzers veranschaulicht. Weitere Informationen zur Benutzerauthentifizierung finden Sie unter Anmeldegrundlagen und bewährte Methoden.

Informationen zum Binden eines Kontos an mehrere Geräte und Anmeldemechanismen: Schnellstart: Schnellstart: Kontoverknüpfung.