Erste Schritte mit Play-Spieldiensten für Android

Achtung : Diese Anleitung bezieht sich auf die Verwendung des Play Games Services Version 1 SDK. Informationen zum neuesten SDK finden Sie in der Dokumentation zum Play Spiele Service Version 2.

Willkommen bei der Android-Spieleentwicklung mit den Google Play-Spieldiensten!

Das Play Spiele SDK bietet plattformübergreifende Google Play-Spieldienste, mit denen du beliebte Spielfunktionen wie Erfolge, Bestenlisten und gespeicherte Spiele ganz einfach in deine Spiele für Tablets und Mobilgeräte integrieren kannst.

In diesem Training erfährst du, wie du eine Beispiel-Spieleanwendung für Android installierst und schnell ein eigenes Android-Spiel erstellst. Die Beispiel-App „Type-a-Number Challenge“ zeigt, wie Sie Erfolge und Bestenlisten in Ihr Spiel einbinden können.

Hinweis

Führen Sie die Schritte in den folgenden Abschnitten aus, um Ihre App vorzubereiten.

Voraussetzungen für Apps

Achten Sie darauf, dass die Build-Datei Ihrer App die folgenden Werte enthält:

• minSdkVersion von 19 höher
• Ein compileSdkVersion von 28 oder höher

Spiel in der Google Play Console einrichten

In der Google Play Console verwalten Sie die Google Play-Spieldienste für Ihr Spiel und konfigurieren Metadaten für die Autorisierung und Authentifizierung Ihres Spiels. Weitere Informationen finden Sie unter Google Play-Spieldienste einrichten.

Eigene Anwendung konfigurieren

Fügen Sie in der Datei build.gradle auf Projektebene sowohl das Maven-Repository von Google als auch das Maven Central Repository in die Abschnitte buildscript und allprojects ein:

  buildscript {
    repositories {
      google()
      mavenCentral()
    }
  }

  allprojects {
    repositories {
      google()
      mavenCentral()
    }
  }

Fügen Sie die Google Play-Dienste-Abhängigkeit für das Play Games SDK der Gradle-Build-Datei Ihres Moduls hinzu, die in der Regel app/build.gradle ist:

  dependencies {
    implementation 'com.google.android.gms:play-services-games:23.1.0'
  }

Beispiel-App-Leitfaden

In diesem Training erfährst du, wie du eine Beispiel-App für Android installierst und schnell ein eigenes Android-Spiel erstellst. Die Beispiel-App „Type-a-Number Challenge“ zeigt, wie Sie Erfolge und Bestenlisten in Ihr Spiel einbinden können.

Schritt 1: Beispielanwendung herunterladen

Für diesen Entwicklerleitfaden müssen Sie die Beispiel-App „Type-a-Number Challenge“ für Android herunterladen.

So laden Sie die Beispielanwendung in Android Studio herunter und richten sie ein:

1. Laden Sie die Android-Beispiele von der Downloadseite für Beispiele herunter.
2. Importieren Sie das Projekt android-basic-samples. Dieses Projekt enthält TypeANumber und andere Android-Spielebeispiele. In Android Studio:
   1. Klicken Sie auf Datei > Projekt importieren.
   2. Rufen Sie das Verzeichnis auf, in das Sie android-basic-samples auf Ihrem Entwicklungscomputer heruntergeladen haben. Wählen Sie die Datei android-basic-samples/build.gradle aus und klicken Sie auf OK.
3. Öffnen Sie im Modul TypeANumber AndroidManifest.xml und ändern Sie den Paketnamen von com.google.example.games.tanc in einen anderen Paketnamen. Der neue Paketname darf nicht mit com.google, com.example oder com.android beginnen.

Schritt 2: Das Spiel in der Google Play Console einrichten

In der Google Play Console verwalten Sie die Google Play-Spieldienste für Ihr Spiel und konfigurieren Metadaten für die Autorisierung und Authentifizierung Ihres Spiels.

So richten Sie das Beispielspiel in der Google Play Console ein:

1. Rufen Sie in der Webbrowser die Google Play Console auf und melden Sie sich an. Wenn Sie sich noch nicht für die Google Play Console registriert haben, werden Sie dazu aufgefordert.
2. Folgen Sie dieser Anleitung, um Ihr Spiel zur Google Play Console hinzuzufügen.
   1. Wenn Sie gefragt werden, ob Sie Google APIs in Ihrer App verwenden, wählen Sie Ich verwende in meinem Spiel noch keine Google APIs aus.
   2. In diesem Entwicklerleitfaden können Sie das Formular mit Ihren eigenen Spieldetails ausfüllen. Der Einfachheit halber können Sie die Platzhaltersymbole und -Screenshots verwenden, die Sie auf der Seite Downloads finden.
3. Folgen Sie dieser Anleitung, um eine OAuth 2.0-Client-ID für Ihre Android-App zu generieren.
   1. Geben Sie beim Verknüpfen der Android-App unbedingt den genauen Paketnamen an, den Sie zuvor beim Umbenennen des Beispielpakets verwendet haben.
   2. Sie können den Assistenten zum Signieren von APKs in Android Studio verwenden, um einen neuen Schlüsselspeicher und ein signiertes Zertifikat zu generieren, falls Sie noch keinen haben. Informationen zum Ausführen des Assistenten zum Generieren von signierten APKs finden Sie unter App in Android Studio signieren.
4. Notieren Sie sich die folgenden Informationen für später:
   1. Ihre Anwendungs-ID: Ein String, der aus Ziffern (in der Regel 12 oder mehr) am Anfang Ihrer Client-ID besteht.
   2. Ihr Signaturzertifikat: Notieren Sie sich, welches Zertifikat Sie beim Einrichten des API-Zugriffs verwendet haben (das Zertifikat, dessen SHA1-Fingerabdruck Sie angegeben haben). Sie sollten dasselbe Zertifikat verwenden, um Ihre Anwendung beim Testen oder Veröffentlichen Ihrer Anwendung zu signieren.
5. Erfolge für „Type-a-Number Challenge“ konfigurieren:
   1. Wählen Sie in der Google Play Console den Tab Erfolge aus.
   2. Fügen Sie die folgenden Beispielerfolge hinzu:

      Name	Beschreibung	Spezielle Hinweise
      Prime	Die Punktzahl muss eine Primzahl sein.	–
      Atavismus	Fordern Sie eine Bewertung von 0 an.	–
      Nicht kacken, Kind	In beiden Modi eine Punktzahl von 9999 anfordern.	–
      Wahnsinn!	Sie erhalten eine Punktzahl von 1337.	Als verborgenen Erfolg festlegen
      Gelangweilt	Spielen Sie das Spiel zehnmal.	Als inkrementellen Erfolg in 10 Schritten definieren
      Wirklich gelangweilt	Spielen Sie das Spiel 100 Mal.	Als inkrementellen Erfolg in 100 Schritten definieren

   3. Notieren Sie sich die IDs (lange alphanumerische Strings) für jeden Erfolg, den Sie erstellt haben.
   4. Konfigurieren Sie Erfolge, die zu Ihrem Spiel passen. Weitere Informationen findest du unter Konzepte hinter Erfolgen und Implementierung von Erfolgen in Android.
6. Bestenlisten für „Type-a-Number Challenge“ konfigurieren:
   1. Wählen Sie in der Google Play Console den Tab Bestenlisten aus.
   2. Fügen Sie zwei Beispiel-Bestenlisten hinzu: eine mit dem Namen „Einfache Highscores“ und eine weitere mit dem Namen „High High Scores“. Beide Bestenlisten sollten eine Punktzahl-Ganzzahl mit null Dezimalstellen und die Reihenfolge Größer ist besser enthalten.
   3. Notieren Sie sich die IDs (lange alphanumerische Strings) für jede von Ihnen erstellte Bestenliste.
   4. Konfigurieren Sie Bestenlisten, die zu Ihrem Spiel passen. Weitere Informationen finden Sie unter Best Practices für Bestenlisten und Best Practices für die Implementierung von Bestenlisten in Android.
7. Fügen Sie Testkonten für Ihr Spiel hinzu. Dieser Schritt ist nur für Apps erforderlich, die noch nicht in der Google Play Console veröffentlicht wurden. Vor der Veröffentlichung der App können sich nur die in der Google Play Console aufgeführten Testkonten anmelden. Nach der Veröffentlichung einer Anwendung kann sich jeder jedoch anmelden.

Warnung :Wenn Sie versuchen, für ein nicht veröffentlichtes Spiel Play Spiele SDK-Aufrufe mit einem Konto auszuführen, das nicht als Testkonto aufgeführt ist, verhalten sich die Google Play-Spieldienste so, als wäre das Spiel nicht vorhanden und Sie würden den ConnectionResult.SIGN_IN_REQUIRED-Rückgabecode zurückgeben. Wenn Sie versuchen, ConnectionResult.startResolutionForResult() zu starten, wird GamesActivityResultCodes.RESULT_SIGN_IN_FAILED zurückgegeben.

Schritt 3: Code ändern

Zum Ausführen des Spiels müssen Sie die Anwendungs-ID als Ressource in Ihrem Android-Projekt konfigurieren. Außerdem müssen Sie Metadaten für Spiele in AndroidManifest.xml hinzufügen.

1. Öffnen Sie res/values/ids.xml und ersetzen Sie die Platzhalter-IDs. Wenn Sie ein Android-Spiel von Grund auf neu erstellen, müssen Sie zuerst diese Datei erstellen.
   1. Geben Sie Ihre Anwendungs-ID in der Ressource app_id an.
   2. Geben Sie jede zuvor erstellte Erfolgs-ID in der entsprechenden achievement_*-Ressource an.
   3. Geben Sie jede zuvor erstellte Bestenlisten-ID in der entsprechenden leaderboard_*-Ressource an.
2. Öffnen Sie AndroidManifest.xml und geben Sie den Paketnamen in das Attribut package des Elements <manifest> ein. Wenn du ein Android-Spiel neu entwickelst, musst du auch den folgenden Code innerhalb des <application>-Elements einfügen:

   <meta-data android:name="com.google.android.gms.games.APP_ID"
       android:value="@string/app_id" />
   <meta-data android:name="com.google.android.gms.version"
      android:value="@integer/google_play_services_version"/>
   

Schritt 4: Spiel testen

Testen Sie die App, bevor Sie sie bei Google Play veröffentlichen, um sicherzustellen, dass die Google Play-Spieldienste richtig in Ihrem Spiel funktionieren.

Hinweis: Wir empfehlen, Tests auf einem physischen Android-Gerät durchzuführen. Wenn du jedoch kein physisches Gerät hast, kannst du Tests mit dem Android-Emulator durchführen. Laden Sie dazu das Emulator-System-Image aus dem SDK-Manager herunter, das unter Android 4.2.2 die Google Play-Dienste enthält.

So führen Sie Ihr Spiel auf Ihrem Testgerät aus:

1. Prüfen Sie, ob Sie das Testkonto eingerichtet haben, mit dem Sie sich in der App anmelden (siehe Schritt 2).
2. Exportieren Sie ein APK und signieren Sie es mit demselben Zertifikat, mit dem Sie das Projekt in der Google Play Console eingerichtet haben. Klicken Sie zum Exportieren eines signierten APK in Android Studio auf Build > Signiertes APK generieren.
3. Installieren Sie das signierte APK mit dem adb-Tool auf Ihrem physischen Testgerät. Informationen zum Installieren einer Anwendung finden Sie unter Auf einem Gerät ausführen.

Warnung: Wenn Sie die App direkt in Android Studio ausführen, signiert Android Studio die App standardmäßig mit Ihrem Debug-Zertifikat. Wenn Sie dieses Debug-Zertifikat nicht beim Einrichten der App in der Google Play Console verwendet haben, führt dies zu Fehlern. Führe ein APK aus, das du exportiert und mit einem Zertifikat signiert hast, das mit einem der Zertifikate übereinstimmt, die du während der App-Einrichtung in der Google Play Console verwendet hast.