Erste Schritte mit den Play-Spieldiensten für Android

Achtung : Diese Anleitung bezieht sich auf die Verwendung des Play-Spieldienste-SDKs Version 1. Informationen zum neuesten SDK finden Sie in der Dokumentation zum Play-Spieldienste v2.

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-Spiele-App für Android installierst und schnell mit der Erstellung deines eigenen Android-Spiels beginnst. Die Beispiel-App "Type-a-Number Challenge" zeigt, wie Sie Erfolge und Bestenlisten in Ihr Spiel integrieren 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:

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

Spiel in der Google Play Console einrichten

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

Eigene App konfigurieren

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

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

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

Fügen Sie die Abhängigkeit für die Google Play-Dienste für das Play Spiele SDK in die Gradle-Build-Datei Ihres Moduls ein. Diese lautet normalerweise app/build.gradle:

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

Beispiel-App-Leitfaden

In diesem Training erfährst du, wie du eine Beispiel-Spiele-App für Android installierst und schnell mit der Entwicklung deines eigenen Android-Spiels beginnst. Die Beispiel-App "Type-a-Number Challenge" zeigt, wie Sie Erfolge und Bestenlisten in Ihr Spiel integrieren können.

Schritt 1: Beispiel-App herunterladen

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

So laden Sie die Beispiel-App 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 Beispiele für Android-Spiele. Gehen Sie dazu in Android Studio so vor:
   1. Klicken Sie auf File > Import Project (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: 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 zur Autorisierung und Authentifizierung Ihres Spiels.

So richtest du das Beispielspiel in der Google Play Console ein:

1. Rufe in deinem Webbrowser die Google Play Console auf und melde dich an. Wenn Sie sich noch nicht für die Google Play Console registriert haben, werden Sie dazu aufgefordert.
2. Folge dieser Anleitung, um dein 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 aus.
   2. Für die Zwecke dieses Entwicklerleitfadens können Sie das Formular mit Ihren eigenen Spieldetails ausfüllen. Der Einfachheit halber können Sie die Platzhaltersymbole und -Screenshots verwenden, die auf der Seite Downloads bereitgestellt werden.
3. So generierst du eine OAuth 2.0-Client-ID für deine Android-App.
   1. Achten Sie beim Verknüpfen Ihrer Android-App darauf, genau den Paketnamen anzugeben, den Sie zuvor beim Umbenennen des Beispielpakets verwendet haben.
   2. Du kannst den Assistenten zum Generieren signierter APKs in Android Studio verwenden, um einen neuen Schlüsselspeicher und ein signiertes Zertifikat zu generieren, falls noch keines vorhanden ist. Informationen zum Ausführen des Assistenten zum Generieren eines signierten APK finden Sie unter App in Android Studio signieren.
4. Notieren Sie sich die folgenden Informationen für später:
   1. Anwendungs-ID: Dabei handelt es sich um einen String, der nur 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 Ihres API-Zugriffs verwendet haben (das Zertifikat, dessen SHA1-Fingerabdruck Sie angegeben haben). Du solltest dasselbe Zertifikat zum Signieren deiner App verwenden, wenn du sie testest oder veröffentlichst.
5. Konfigurieren Sie Erfolge für „Type-a-Number Challenge“:
   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	Ermitteln Sie einen Wert, der eine Primzahl ist.	–
      Atavismus	Fordere eine Punktzahl von 0 an.	–
      Nicht übermütig, Kind	Fordern Sie in beiden Modi eine Punktzahl von 9999 an.	–
      OMG, DU! TEH UBER LEET!	Sie erhalten eine Punktzahl von 1337.	Mach diesen Erfolg zu einem verborgenen Erfolg.
      Gelangweilt	Spielen Sie das Spiel 10 Mal.	Als inkrementellen Erfolg in 10 Schritten festlegen
      Wirklich langweilig	Spielen Sie das Spiel 100 Mal.	Als inkrementellen Erfolg in 100 Schritten festlegen

   3. Notieren Sie sich die IDs (lange alphanumerische Strings) für jeden erstellten Erfolg.
   4. Konfigurieren Sie Erfolge, die für Ihr Spiel geeignet sind. Weitere Informationen findest du in den Konzepten hinter den Erfolgen und in der Implementierung von Erfolgen in Android.
6. Konfigurieren Sie die Bestenlisten für „Type-a-Number Challenge“:
   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 mit dem Namen "Hard High Scores". Beide Bestenlisten sollten eine Punktzahlformatierung in Ganzzahlen und ohne Dezimalstellen haben und als Sortierungstyp Größer ist besser angegeben werden.
   3. Notieren Sie sich die IDs (lange alphanumerische Zeichenfolgen) für jede Bestenliste, die Sie erstellt haben.
   4. Konfigurieren Sie Bestenlisten, die zu Ihrem Spiel passen. Weitere Informationen findest du in den Konzepten hinter Bestenlisten und in der 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 jedoch jeder anmelden.

Warnung :Wenn Sie versuchen, Play Spiele SDK-Aufrufe für ein unveröffentlichtes Spiel 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 erhalten den ConnectionResult.SIGN_IN_REQUIRED-Rückgabecode. Wenn Sie versuchen, ConnectionResult.startResolutionForResult() zu starten, erhalten Sie GamesActivityResultCodes.RESULT_SIGN_IN_FAILED zurück.

Schritt 3: Code ändern

Damit Sie das Spiel ausführen können, müssen Sie die App-ID in Ihrem Android-Projekt als Ressource konfigurieren. Außerdem musst du Metadaten zum Spiel in der 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 alle zuvor erstellten Bestenlisten-IDs in der entsprechenden leaderboard_*-Ressource an.
2. Öffnen Sie AndroidManifest.xml und geben Sie Ihren Paketnamen in das Attribut package des Elements <manifest> ein. Wenn du ein Android-Spiel von Grund auf neu entwickelst, solltest du auch den folgenden Code in das <application>-Element 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

Teste die App, bevor du sie bei Google Play veröffentlichst, um sicherzustellen, dass die Google Play-Spieldienste in deinem Spiel ordnungsgemäß funktionieren.

Hinweis: Wir empfehlen, Tests auf einem physischen Android-Gerät durchzuführen. Wenn Sie jedoch kein physisches Gerät haben, können Sie Tests auch mit dem Android-Emulator durchführen. Lade dazu unter Android 4.2.2 das Emulator-Systemimage herunter, das die Google Play-Dienste im SDK Manager enthält.

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

1. Prüfen Sie, ob Sie das Testkonto eingerichtet haben, mit dem Sie sich bei der Anwendung anmelden (wie in Schritt 2 beschrieben).
2. Exportiere ein APK und signiere es mit demselben Zertifikat, mit dem du das Projekt in der Google Play Console eingerichtet hast. Klicke zum Exportieren eines signierten APK in Android Studio auf Build > Signiertes APK generieren.
3. Installiere das signierte APK mit dem adb-Tool auf deinem Testgerät. Informationen zum Installieren einer Anwendung finden Sie unter Auf einem Gerät ausführen.

Warnung :Wenn du die App direkt in Android Studio ausführst, signiert Android Studio sie standardmäßig mit deinem Debug-Zertifikat. Wenn Sie dieses Debug-Zertifikat beim Einrichten der App in der Google Play Console nicht verwendet haben, verursacht dies Fehler. Du musst ein APK ausführen, das du exportiert und mit einem Zertifikat signiert hast, das mit einem der Zertifikate übereinstimmt, die du bei der Einrichtung der App in der Google Play Console verwendet hast.