Erste Schritte mit Play Spiele-Diensten für Android

Achtung :Diese Anleitung bezieht sich auf die Verwendung des SDKs für die Play-Spieldienste v1. Informationen zur neuesten SDK-Version finden Sie in der Dokumentation für Version 2.

Willkommen bei der Android-Spielentwicklung mit den Google Play-Spieldiensten.

Das Play Spiele SDK bietet plattformübergreifende Google Play-Spieldienste, mit denen Sie beliebte Gaming-Funktionen wie Erfolge, Bestenlisten und gespeicherte Spiele ganz einfach in Ihre Tablet- und Mobilspiele einbinden können.

In diesem Training erfahren Sie, wie Sie eine Beispiel-Spielanwendung für Android installieren und schnell mit dem Erstellen Ihres eigenen Android-Spiels beginnen. 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 in der Build-Datei Ihrer App die folgenden Werte verwendet werden:

• minSdkVersion von 19 oder höher
• 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 Spiele-Dienste einrichten.

App konfigurieren

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

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

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

Fügen Sie die Abhängigkeit für Google Play-Dienste für das Play Spiele SDK der Gradle-Builddatei des Moduls hinzu. Diese Datei heißt in der Regel app/build.gradle:

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

Leitfaden für Beispiel-Apps

In diesem Training erfahren Sie, wie Sie eine Beispiel-Spiel-App für Android installieren und schnell mit dem Erstellen Ihres eigenen Android-Spiels beginnen. Die Beispiel-App „Type-a-Number Challenge“ zeigt, wie Sie Erfolge und Bestenlisten in Ihr Spiel einbinden können.

Schritt 1: Beispiel-App herunterladen

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

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

1. Laden Sie die Android-Beispiele von der Downloadseite für Samples herunter.
2. Importieren Sie das Projekt android-basic-samples. Dieses Projekt enthält TypeANumber und andere Android-Spielbeispiele. So gehts in Android Studio:
   1. Klicken Sie auf Datei > Projekt importieren.
   2. Rufen Sie das Verzeichnis auf, in das Sie android-basic-samples auf Ihren 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 die Datei AndroidManifest.xml und ändern Sie den Paketnamen von com.google.example.games.tanc in einen anderen Namen. Der neue Paketname darf nicht mit com.google, com.example oder com.android beginnen.

Schritt 2: 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 die Google Play Console in Ihrem Webbrowser 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 der 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.
   2. Für diesen Entwicklerleitfaden können Sie das Formular mit Ihren eigenen Spieldetails ausfüllen. Sie können die Platzhaltersymbole und Screenshots auf der Seite Downloads verwenden.
3. Folgen Sie dieser Anleitung, um eine OAuth 2.0-Client-ID für Ihre Android-App zu generieren.
   1. Achten Sie beim Verknüpfen Ihrer Android-App darauf, genau den Paketnamen anzugeben, den Sie zuvor beim Umbenennen des Beispielpakets verwendet haben.
   2. Mit dem Assistenten zum Generieren eines signierten APKs in Android Studio können Sie einen neuen Schlüsselspeicher und ein signiertes Zertifikat generieren, falls Sie noch keines haben. Informationen zum Ausführen des Assistenten zum Generieren eines 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: Dies ist ein String, der nur aus Ziffern besteht (in der Regel mindestens 12) und sich am Anfang Ihrer Client-ID befindet.
   2. Signaturzertifikat: Notieren Sie sich, welches Zertifikat Sie beim Einrichten Ihres API-Zugriffs verwendet haben (das Zertifikat, dessen SHA1-Fingerabdruck Sie angegeben haben). Sie sollten dasselbe Zertifikat verwenden, um Ihre App beim Testen oder Veröffentlichen zu signieren.
5. So konfigurierst du die Erfolge für die Herausforderung „Eine Zahl eingeben“:
   1. Wählen Sie in der Google Play Console den Tab Erfolge aus.
   2. Fügen Sie die folgenden Beispielerfolge hinzu:

      Name	Beschreibung	Besondere Hinweise
      Prime	Erzielen Sie eine Punktzahl, die einer Primzahl entspricht.	Keine
      Humble	Setzen Sie eine Punktzahl von 0 fest.	Keine
      Don't get cocky, kid	Setzen Sie eine Punktzahl von 9.999 in einem beliebigen Modus fest.	Keine
      OMG U R TEH UBER LEET!	Erzielen Sie eine Punktzahl von 1337.	Als versteckten Erfolg definieren
      Bored	Spielen Sie das Spiel 10 Mal.	Als inkrementellen Erfolg in zehn Schritten definieren
      Really Really Bored	Spielen Sie das Spiel 100 Mal.	Als inkrementellen Erfolg in 100 Schritten definieren

   3. Notieren Sie sich die IDs (lange alphanumerische Strings) für alle von Ihnen erstellten Erfolge.
   4. Konfigurieren Sie Erfolge, die in Ihr Spiel passen. Weitere Informationen finden Sie unter Konzepte hinter Erfolgen und Erfolge in Android implementieren.
6. Bestenlisten für die Herausforderung „Eine Zahl eingeben“ konfigurieren:
   1. Wählen Sie in der Google Play Console den Tab Bestenlisten aus.
   2. Fügen Sie zwei Beispielbestenlisten hinzu: eine mit dem Namen „Beste Ergebnisse – Einfach“ und eine mit dem Namen „Beste Ergebnisse – Schwer“. Beide Bestenlisten sollten die Formatierung „Ganze Zahlen“ mit 0 Dezimalen und die Sortierreihenfolge Je höher, desto besser verwenden.
   3. Notieren Sie sich die IDs – lange alphanumerische Zeichenfolgen – für alle erstellten Bestenlisten.
   4. Konfigurieren Sie Bestenlisten, die in Ihr Spiel passen. Weitere Informationen finden Sie unter Bestenlisten – Konzepte und Bestenlisten in Android implementieren.
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. Sobald eine Anwendung jedoch veröffentlicht wurde, kann sich jeder anmelden.

Warnung :Wenn Sie versuchen, Play Spiele SDK-Aufrufe für ein nicht veröffentlichtes Spiel mit einem Konto auszuführen, das nicht als Testkonto aufgeführt ist, verhalten sich die Google Play Spiele-Dienste so, als würde das Spiel nicht existieren. Sie erhalten dann den Rückgabecode ConnectionResult.SIGN_IN_REQUIRED. Wenn Sie versuchen, ConnectionResult.startResolutionForResult() zu starten, erhalten Sie GamesActivityResultCodes.RESULT_SIGN_IN_FAILED zurück.

Schritt 3: Code modifizieren

Um das Spiel auszuführen, müssen Sie die App-ID in Ihrem Android-Projekt als Ressource konfigurieren. Außerdem müssen Sie Metadaten für Spiele in der AndroidManifest.xml angeben.

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 diese Datei zuerst erstellen.
   1. Geben Sie Ihre Anwendungs-ID in der app_id-Ressource an.
   2. Geben Sie in der entsprechenden achievement_*-Ressource die ID für jedes zuvor erstellte Achievement an.
   3. Geben Sie in der entsprechenden leaderboard_*-Ressource jede zuvor erstellte Bestenlisten-ID an.
2. Öffnen Sie AndroidManifest.xml und geben Sie den Paketnamen in das package-Attribut des <manifest>-Elements ein. Wenn Sie ein Android-Spiel von Grund auf neu erstellen, fügen Sie dem <application>-Element auch den folgenden Code hinzu:

   <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

Damit die Google Play-Spieldienste in Ihrem Spiel ordnungsgemäß funktionieren, sollten Sie die App testen, bevor Sie sie bei Google Play veröffentlichen.

Hinweis: Wir empfehlen, den Test auf einem physischen Android-Gerät durchzuführen. Wenn Sie jedoch kein physisches Gerät haben, können Sie die Tests mit dem Android-Emulator durchführen. Laden Sie dazu das Emulator-Systemimage mit den Google Play-Diensten unter Android 4.2.2 aus dem SDK-Manager herunter.

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

1. Prüfen Sie, ob Sie das Testkonto eingerichtet haben, mit dem Sie sich in der App anmelden (wie in Schritt 2 beschrieben).
2. Exportieren Sie ein APK und signieren Sie es mit demselben Zertifikat, mit dem Sie das Projekt in der Google Play Console eingerichtet haben. Wenn Sie ein signiertes APK in Android Studio exportieren möchten, klicken Sie auf Build > Generate Signed APK (Signiertes APK generieren).
3. Installieren Sie die 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 Anwendung direkt über Android Studio ausführen, wird sie standardmäßig mit Ihrem Debug-Zertifikat signiert. Wenn Sie dieses Debug-Zertifikat nicht beim Einrichten der Anwendung in der Google Play Console verwendet haben, führt dies zu Fehlern. Führen Sie ein APK aus, das Sie exportiert und mit einem Zertifikat signiert haben, das mit einem der Zertifikate übereinstimmt, die Sie bei der Einrichtung der Anwendung in der Google Play Console verwendet haben.