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.

Anforderungen

• Ein PlayFab-Entwicklerkonto.
• Eine installierte Kopie des Unity-Editor. 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 entweder das PlayFab Editor-Erweiterungspaket, um das SDK zu installieren, oder installieren Sie das SDK direkt. Die PlayFab-Editor-Erweiterungen sind ein eigenständiges Unity-Plug-In, das die Installation des SDK und die Konfiguration einiger PlayFab-Einstellungen für Ihren Titel optimiert. Informationen zum Installieren des SDK ohne die PlayFab-Editor-Erweiterungen finden Sie unter Installieren des PlayFab SDK ohne Editor-Erweiterungen für Unity.

1. Laden Sie das PlayFab Unity Editor Extensions Asset Package 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. Um die PlayFab Unity Editor Extensions in Ihr Projekt zu importieren, wählen Sie Importieren aus.

5. Wenn der Import abgeschlossen ist, sollte der Bereich "PlayFab Unity Editor Extensions" automatisch geöffnet werden, in dem das Dialogfeld für die SDK-Installation angezeigt wird.

   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>Editor Erweiterungen auswählen.

   

6. 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 durchführen können, müssen Sie eine PlayFabSharedSettings.asset erstellen und die Titel-ID angeben, um den Aufruf zu empfangen. So legen Sie die Titel-ID fest:

1. Wählen Sie PlayFab>MakePlayFabSharedSettings aus, um das Einstellungsobjekt zu erstellen und im Inspektorbereich zu öffnen.

2. Legen Sie Ihre Titel-ID im Inspektor fest.

   

3. Jetzt können Sie jederzeit auch die aktuelle Titel-ID auf der Registerkarte Einstellungen im Bereich Editor Erweiterungen anzeigen und ändern.

Der geheime Entwicklerschlüssel ist nicht standardmäßig festgelegt. Wenn Sie einen Serverbuild erstellen, stellen Sie sicher, dass Sie den geheimen Schlüssel in PlayFabSharedSettings.asset angeben.

Achten Sie andernfalls darauf, dass der geheime Schlüssel beim Erstellen Ihres Spielclients nicht festgelegt ist . Weitere Informationen zu geheimen Schlüsseln finden Sie unter Verwaltung geheimer Schlüssel.

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
• Klicken Sie oben im Editor auf die Schaltfläche Wiedergabe .

Die folgende Meldung sollte im Unity-Konsolenbereich angezeigt werden.

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.