Erste Schritte mit Play Spiele-Diensten für Android

Nach der Einstellung der Google-Anmeldung-API wird das games v1 SDK im Jahr 2026 entfernt. Ab Februar 2025 kannst du bei Google Play keine Titel mehr veröffentlichen, die neu in Games SDK V1 integriert wurden. Wir empfehlen, stattdessen das Games SDK V2 zu verwenden.
Bestehende Titel mit den vorherigen Integrationen für Spiele v1 funktionieren zwar noch einige Jahre, aber wir empfehlen Ihnen, ab Juni 2025 zu Version 2 zu migrieren.
In diesem Leitfaden wird die Verwendung des Play Games Services SDK V1 beschrieben. Informationen zur neuesten SDK-Version finden Sie in der Dokumentation zu Version 2.

Willkommen bei der Android-Spieleentwicklung 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 Kurs erfahren Sie, wie Sie eine Beispielspielanwendung für Android installieren und schnell mit der Entwicklung Ihres eigenen Android-Spiels beginnen können. 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:

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

Spiel in der Google Play Console einrichten

Über die Google Play Console können Sie die Google Play-Spieldienste für Ihr Spiel verwalten sowie Metadaten zur Autorisierung und Authentifizierung Ihres Spiels konfigurieren. Weitere Informationen finden Sie unter Google Play-Spieledienste einrichten.

App konfigurieren

Fügen Sie in der Datei build.gradle auf Projektebene das Maven-Repository von Google und das Maven Central Repository in die Abschnitte buildscript und 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 Games SDK in die Gradle-Build-Datei des Moduls ein, die in der Regel app/build.gradle ist:

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

Leitfaden für Beispiel-App

In diesem Kurs erfahren Sie, wie Sie eine Beispiel-Spiele-App für Android installieren und schnell mit der Entwicklung Ihres eigenen Android-Spiels beginnen können. 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 diese Entwickleranleitung müssen Sie die Android-Beispielanwendung „Type-a-Number Challenge“ 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 android-basic-samples-Projekt. Dieses Projekt enthält TypeANumber und andere Android-Spiel-Samples. So gehts in Android Studio:
   1. Klicken Sie auf File > Import Project (Datei > Projekt importieren).
   2. Rufen Sie auf Ihrem Entwicklercomputer das Verzeichnis auf, in das Sie android-basic-samples 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 Paketnamen. Der neue Paketname darf nicht mit com.google, com.example oder com.android beginnen.

Schritt 2: Spiel in der Google Play Console einrichten

Über die Google Play Console können Sie die Google Play-Spieldienste für Ihr Spiel verwalten und Metadaten zur Autorisierung und Authentifizierung Ihres Spiels konfigurieren.

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 in 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 auf der Seite Downloads bereitgestellten Platzhaltersymbole und ‑screenshots 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, dass Sie den genauen Paketnamen angeben, den Sie zuvor beim Umbenennen des Beispielpakets verwendet haben.
   2. Wenn Sie noch keinen Keystore und kein signiertes Zertifikat haben, können Sie mit dem Assistenten „Signiertes APK generieren“ in Android Studio einen neuen Keystore und ein neues signiertes Zertifikat erstellen. Informationen zum Ausführen des Assistenten zum Generieren signierter APKs finden Sie unter App in Android Studio signieren.
4. Notieren Sie sich die folgenden Informationen für später:
   1. Ihre Anwendungs-ID: Das ist ein String, der nur aus Ziffern besteht (in der Regel 12 oder mehr) und am Anfang Ihrer Client-ID steht.
   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 zum Signieren Ihrer App verwenden, wenn Sie sie testen oder veröffentlichen.
5. Erfolge für die 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	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 jeden erstellten Erfolg.
   4. Konfigurieren Sie Erfolge, die in Ihr Spiel passen. Weitere Informationen finden Sie unter Konzepte für Erfolge und Erfolge in Android implementieren.
6. Bestenlisten für die Herausforderung „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 „Easy High Scores“ und eine mit dem Namen „Hard High Scores“. Beide Bestenlisten sollten die Formatierung „Ganzzahliger Score“ mit 0 Dezimalstellen und den Ordnungstyp Größer ist 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 Konzepte für Bestenlisten 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. Bevor die App veröffentlicht wird, können sich nur die in der Google Play Console aufgeführten Testkonten anmelden. Sobald eine Anwendung veröffentlicht wurde, kann sich jedoch jeder anmelden.

Warnung :Wenn Sie versuchen, Play Games 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-Spieledienste so, als ob das Spiel nicht vorhanden wäre, und Sie erhalten den Rückgabecode ConnectionResult.SIGN_IN_REQUIRED. Wenn Sie versuchen, ConnectionResult.startResolutionForResult() zu starten, erhalten Sie GamesActivityResultCodes.RESULT_SIGN_IN_FAILED.

Schritt 3: Code modifizieren

Damit das Spiel ausgeführt werden kann, müssen Sie die App-ID in Ihrem Android-Projekt als Ressource konfigurieren. Außerdem müssen Sie die Metadaten von Spielen 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 diese Datei zuerst erstellen.
   1. Geben Sie die Anwendungs-ID in der Ressource app_id an.
   2. Geben Sie jede Achievement-ID, die Sie zuvor erstellt haben, in der entsprechenden achievement_*-Ressource an.
   3. Geben Sie jede der zuvor erstellten Bestenlisten-IDs 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 Sie ein Android-Spiel von Grund auf neu erstellen, fügen Sie den folgenden Code in das <application>-Element ein:

   <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 richtig funktionieren, sollten Sie die Anwendung testen, bevor Sie sie bei Google Play veröffentlichen.

Hinweis: Es wird empfohlen, Tests auf einem physischen Android-Gerät durchzuführen. Wenn Sie kein physisches Gerät haben, können Sie die Android-Emulatoren verwenden. 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, mit dem Sie sich in der App anmelden, wie in Schritt 2 beschrieben eingerichtet haben.
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 erstellen).
3. Installieren Sie die signierte APK-Datei 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, signiert Android Studio die Anwendung standardmäßig mit Ihrem Debug-Zertifikat. Wenn Sie dieses Debug-Zertifikat nicht beim Einrichten der Anwendung in der Google Play Console verwendet haben, führt dies zu Fehlern. Achten Sie darauf, dass Sie ein APK ausführen, das Sie mit einem Zertifikat exportiert und signiert haben, das mit einem der Zertifikate übereinstimmt, die Sie bei der Einrichtung der Anwendung in der Google Play Console verwendet haben.