Erste Schritte mit dem Google Play Spiele-Plug-in für Unity

In diesem Thema wird beschrieben, wie Sie Ihr Unity-Projekt für die Verwendung des Google Play Spiele-Plug-in für Unity Aufgaben sind die Einrichtung des Projekts, die Auswahl einer sozialen Plattform und die Einrichtung Spieleranmeldung

Hinweis

• In der Google Play Console Richte die Play Console für dein Spiel ein.

• In der Google Play Console Erfolg erstellen

Plug-in-Installation

1. Rufen Sie das Plug-in mit einer der folgenden Optionen ab:

   • Klonen Sie GitHub-Repository in Ihr Dateisystem.

   • Laden Sie die GitHub-Repository als ZIP-Datei herunterladen und sie dann entpacken.

2. Suchen Sie im Verzeichnis current-build nach der Datei unitypackage. Diese Datei ist das Plug-in. Sie sollte zum Beispiel in etwa so aussehen:

     current-build/GooglePlayGamesPluginForUnity-X.YY.ZZ.unitypackage
   

3. Öffnen Sie Ihr Spielprojekt in Unity.

4. Importieren Sie die Datei unitypackage in die Assets Ihres Projekts, indem Sie auf das Assets > Paket importieren > Benutzerdefiniertes Paket.

5. Achten Sie darauf, dass Ihre aktuelle Build-Plattform auf Android festgelegt ist.

   1. Klicken Sie im Hauptmenü auf Datei > Build-Einstellungen...

   2. Wählen Sie Android aus und klicken Sie auf Plattform wechseln.

   3. Unter Fenster > Google Play Spiele Wenn nicht. Aktualisieren Sie die Assets, indem Sie auf Assets > Aktualisieren und und versuchen Sie dann noch einmal, die Build-Plattform festzulegen.

Android-Ressourcen von der Play Console erhalten

Alle Erfolge, Bestenlisten und Ereignisse, die Sie in Die Play Console enthält eine Android-Ressource, die du für ein Unity-Projekt eingerichtet.

1. Hier findest du die Android-Ressourcen für dein Spiel.

   1. Öffne in der Play Console das Play-Spieldienste-Projekt für für Ihr Spiel.

   2. Klicken Sie auf den Tab Erfolge und dann auf Ressourcen abrufen.

   3. Klicken Sie im Fenster Ressourcen exportieren auf den Tab Android.

   4. Wählen Sie den XML-Inhalt aus und kopieren Sie ihn.

Unity-Projekt einrichten

1. Fügen Sie Ihrem Unity-Projekt die Android-Ressourcen hinzu.

   1. Klicken Sie in Unity auf ** Window > Google Play Spiele > Einrichtung... > Android-Einrichtung **.

   2. Führen Sie die folgenden Schritte in den Einrichtungsfenstern aus:

   3. Verzeichnis zum Speichern von Konstanten: Der Ordner für die Konstanten-Datei.

   4. Name der Konstantenklasse: Der Name der zu erstellenden C#-Klasse, einschließlich des Namespace.

   5. Ressourcendefinition: Fügen Sie hier die Daten zu Android-Ressourcen aus der Play Console ein.

   6. Webclient-ID: Die Client-ID der verknüpften Web-App. Dies ist nur erforderlich, wenn Sie ein webbasiertes Back-End haben für Ihr Spiel und benötigen einen Server-Authentifizierungscode, um ihn gegen ein Zugriffstoken auszutauschen, Back-End-Server oder wenn Sie ein ID-Token benötigen, damit der Spieler andere spieleunabhängige API-Aufrufe.

   7. Klicken Sie auf Einrichten. Dadurch wird dein Spiel mit der Client-ID und generiert eine C#-Klasse, die Konstanten für jedes Ihrer Android- Ressourcen.

Android-Einrichtung

Legen Sie den Pfad zu Ihrer Android SDK-Installation in Unity fest. Sie befindet sich in im Menü „Einstellungen“ unter External Tools (Externe Tools) aus.

Wenn du dein Unity-Spiel für Google Play Spiele auf Android konfigurieren möchtest, Öffnen Sie den Android SDK-Manager und vergewissern Sie sich, dass Sie Folgendes heruntergeladen haben: Pakete. Je nachdem, ob Sie den SDK Manager aus Android Studio verwenden, oder den eigenständigen SDK-Manager verwenden, können die Namen der Komponenten abweichen. - Google Play-Dienste - Android Support Library - Lokales Maven-Repository für Supportbibliotheken (auch als Android-Support bezeichnet) Repository) - Google-Repository - Android 6.0 (API 23) – die Mindestversion des SDK ist davon nicht betroffen.

Konfigurieren Sie als Nächstes den Paketnamen Ihres Spiels. Klicken Sie dazu auf Datei > Erstellen Einstellungen, wählen Sie die Android-Plattform aus und klicken Sie auf Player Settings (Player-Einstellungen), um um das Fenster mit den Player-Einstellungen von Unity anzuzeigen. Suchen Sie in diesem Fenster nach Set ID unter Weitere Einstellungen. Gib dort den Paketnamen ein (z. B. com.example.my.awesome.game).

Damit Sie sich in den Play-Spieldiensten anmelden können, müssen Sie Ihre APK-Datei signieren, sollten Sie unbedingt mit dem korrektes Zertifikat, d. h. das Zertifikat, das dem SHA1-Zertifikat entspricht Fingerabdruck, den Sie bei der Einrichtung in der Developer Console eingegeben haben.

Klicken Sie dann auf den Menüpunkt Fenster |Google Play Spiele|Einrichtung – Android-Einrichtung. Daraufhin wird der Android-Einrichtungsbildschirm angezeigt.

Geben Sie den Namen der Konstantenklasse ein. Dies ist der Name der voll qualifizierten Klasse die aktualisiert (oder erstellt) wird und die IDs der Spielressourcen enthält. Das Format des Namens ist <namespace>.<classname>. Beispiel: AwesomeGame.GPGSIds

Fügen Sie die Ressourcendefinitionsdaten ein. Dies sind die XML-Daten aus Google Play. Developer Console, die die Ressourcen-IDs und die Anwendungs-ID enthält für Android.

Diese Daten findest du in der Google Play Developer Console unter Ressourcen“ auf einer der Ressourcenseiten (z.B. Erfolge oder Bestenlisten) und dann auf „Android“.

Fügen Sie die Daten in den Textfeld ein und klicken Sie auf die Schaltfläche Einrichten.

Hinweis:Wenn Sie eine Webanwendung oder einen Back-End-Server für Ihr Spiel verwenden, können Sie die Webanwendung mit dem Spiel verknüpfen, ID-Token und/oder E-Mail-Adresse. Verknüpfen Sie dazu eine Webanwendung mit dem in der Google Play Developer Console auf und gib die Client-ID für der Webanwendung in das Einrichtungsdialogfeld ein.

Zusätzliche Anweisungen zum Erstellen von Apps für Android unter Windows

Wenn Sie Windows verwenden, müssen Sie sicherstellen, dass Ihre Java SDK-Installation auf die Unity zugreifen kann. Ziel

1. Legen Sie die Umgebungsvariable JAVA_HOME auf Ihren Java SDK-Installationspfad fest. (z. B. C:\Program Files\Java\jdk1.7.0_45).
2. Fügen Sie der Umgebungsvariablen PATH den Ordner bin des Java SDK hinzu. (z. B. C:\Program Files\Java\jdk1.7.0_45\bin)
3. Neu starten.

Umgebungsvariablen bearbeiten: Klicken Sie unter Windows 2000/XP/Vista/7 mit der rechten Maustaste Arbeitsplatz, dann Eigenschaften und dann Erweiterte Systemeigenschaften (oder Systemeigenschaften und klicken Sie dann auf den Tab Erweitert). Klicken Sie dann auf Umgebungsvariablen: Drücken Sie auf Windows 8-Geräten Windows-Taste + W und suchen Sie für Umgebungsvariablen. Weitere Informationen finden Sie in der Dokumentation. für Ihre Windows-Version.

Projekt ausführen

Wenn Sie mit dem Smoketest-Beispiel arbeiten, sollten Sie in der Lage sein, zu erstellen, und das Projekt zu diesem Zeitpunkt durchführen. Sie sehen den automatischen Anmeldeversuch, wenn Smoketest beginnt.

Klicken Sie zum Erstellen und Ausführen unter Android auf Datei > Build Settings (Build-Einstellungen), wähle die Android-Plattform und dann Wechseln Sie zur Plattform und dann auf Erstellen und ausführen.

Soziale Plattform auswählen

Das Google Play Spiele-Plug-in implementiert die Social-Media-Schnittstelle, um die Kompatibilität mit Spielen zu verbessern, die diese Schnittstelle bereits bei der Integration in andere Plattformen. Einige Funktionen sind jedoch nur bei Play Spiele verfügbar: die als Erweiterungen der standardmäßigen, von Unity bereitgestellten Benutzeroberfläche für soziale Netzwerke angeboten werden.

Auf die Standard-API-Aufrufe kann über das Objekt Social.Active zugegriffen werden. ein Verweis auf eine ISocialPlatform-Schnittstelle. Die Nicht-Standard- Sie können auf Google Play Spiele-Erweiterungen zugreifen, indem Sie die Spalte Social.Active Objekt der PlayGamesPlatform-Klasse, wobei die zusätzlichen Methoden verfügbar.

Plug-in verwenden, ohne die standardmäßige soziale Plattform zu überschreiben

Wenn du PlayGamesPlatform.Activate anrufst, wird Google Play Spiele zu deinem Standardimplementierung von sozialen Plattformen, was bedeutet, dass statische Aufrufe von Methoden in Social und Social.Active werden von Google Play Spiele . Dies ist bei den meisten Spielen, für die das Plug-in verwendet wird, das gewünschte Verhalten.

Falls Sie jedoch aus irgendeinem Grund die Standardimplementierung beibehalten möchten, (zum Beispiel, um Erfolge und Bestenlisten an einen sozialen Plattformen) können Sie das Google Play Spiele-Plug-in ohne die Standardeinstellung überschreiben. Ziel

1. PlayGamesPlatform.Activate nicht anrufen
2. Wenn Xyz der Name einer Methode ist, die Sie für die Klasse Social aufrufen möchten, führen Sie nicht Social.Xyz aufrufen. Rufen Sie stattdessen PlayGamesPlatform.Instance.Xyz an.
3. Verwende Social.Active nicht, wenn du mit Google Play Spiele interagierst. Stattdessen PlayGamesPlatform.Instance verwenden.

Auf diese Weise können Sie Punktzahlen und Erfolge gleichzeitig mehr soziale Plattformen:

    // Submit achievement to original default social platform
    Social.ReportProgress("MyAchievementIdHere", 100.0f, callback);

    // Submit achievement to Google Play
    PlayGamesPlatform.Instance.ReportProgress("MyGooglePlayAchievementIdHere", 100.0f, callback);

Anmeldedienst bestätigen

Es wird automatisch versucht, über die Anmeldedienst beim Öffnen des Spiels Wenn die Verbindung hergestellt wird, wird im Spiel eine Anmeldeaufforderung angezeigt und Sie können Google Play Spiele-Plug-in für Unity

Wenn ein Nutzer Google Play Spiele noch nie auf seinem Gerät verwendet hat, werden automatisch über den einmaligen Einrichtungsbildschirm geleitet, auf dem ein Play Spiele-Spiel erstellt wird. Konto.

Warten Sie in der Methode Start Ihres Skripts das Ergebnis des automatischen Anmeldeversuch, Authentifizierungsstatus abrufen und Play Spiele deaktivieren Dienstfunktionen, wenn der Nutzer nicht angemeldet ist.

    using GooglePlayGames;

    public void Start() {
      PlayGamesPlatform.Instance.Authenticate(ProcessAuthentication);
    }

    internal void ProcessAuthentication(SignInStatus status) {
      if (status == SignInStatus.Success) {
        // Continue with Play Games Services
      } else {
        // Disable your integration with Play Games Services or show a login button
        // to ask users to sign-in. Clicking it should call
        // PlayGamesPlatform.Instance.ManuallyAuthenticate(ProcessAuthentication).
      }
    }
}

Der Ergebniscode ist eine Aufzählung, mit der Sie den Grund für eine Anmeldung ermitteln können. Fehler.

Wenn Sie die soziale Plattform von Unity bevorzugen, können Sie alternativ die folgenden Code:

  using GooglePlayGames;

  public void Start() {
    PlayGamesPlatform.Activate();
    Social.localUser.Authenticate(ProcessAuthentication);
  }

Sie können die Google Play Spiele API erst aufrufen, wenn eine erfolgreiche Rückgabewert von Authenticate. Daher empfehlen wir, in Spielen eine Stand-by-Bildschirm, bis der Callback aufgerufen wird, damit Nutzer nicht mit dem Spielen beginnen können bis die Authentifizierung abgeschlossen ist.

Serverauthentifizierungscodes abrufen

Um auf einem Back-End-Webserver im Namen des aktuellen müssen Sie einen Authentifizierungscode von der Client-Anwendung an Ihre Webserveranwendung übergeben. Der Code kann dann gegen ein Zugriffstoken für Aufrufe an die verschiedenen APIs. Weitere Informationen zum finden Sie unter Google Log-in für Websites

So rufen Sie den serverseitigen Zugriffscode ab:

1. Konfigurieren Sie die Web-Client-ID der Webanwendung, die mit Ihrem Spiel verknüpft ist in der Spiele Console.

2. Rufen Sie PlayGamesPlatform.Instance.RequestServerSideAccess auf, sobald der Spieler authentifiziert, um den serverseitigen Zugriffscode abzurufen.

3. Übergeben Sie diesen Code an Ihre Serveranwendung.

  PlayGamesPlatform.Instance.RequestServerSideAccess(
    /* forceRefreshToken= */ false,
    code -> {
      // send code to server
    });

Funktionen einrichten und hinzufügen

• Aktivieren Sie Funktionen der Play-Spieldienste.

• Füge deinem Spiel mithilfe der Play-Spieldienste-APIs Funktionen hinzu:

  • Erfolge

  • Bestenlisten

  • Freunde

  • Spiele speichern

  • Spielerstatistiken

  • Events