Erste Schritte mit den Play-Spieldiensten für Android

Achtung : Dieser Leitfaden bezieht sich auf die Verwendung des Play-Spieldiensten-SDKs v1. Informationen zum neuesten SDK finden Sie in der Dokumentation zum Play-Spieldienste-Dienst 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 Spielfunktionen wie Erfolge, Bestenlisten und gespeicherte Spiele ganz einfach in Ihre Spiele für Tablets und Mobilgeräte integrieren können.

In diesem Training erfahren Sie, wie Sie eine Beispiel-Spiele-App für Android installieren und schnell Ihr eigenes Android-Spiel erstellen. Die Beispiel-App Type-a-Number Challenge demonstriert, 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 verwendet:

• 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-Spieldienste einrichten.

Eigene App konfigurieren

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

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

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

Fügen Sie die Abhängigkeit von den Google Play-Diensten für das Play Spiele SDK in die Gradle-Build-Datei Ihres Moduls ein. Das ist normalerweise app/build.gradle:

  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-Spiele-App für Android installierst und schnell ein eigenes Android-Spiel entwickelst. Die Beispiel-App Type-a-Number Challenge demonstriert, 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 Seite zum Herunterladen von Beispielen herunter.
2. Importieren Sie das Projekt android-basic-samples. Dieses Projekt enthält TypeANumber und andere Android-Spiele. Gehen Sie dazu in Android Studio so vor:
   1. Klicken Sie auf Datei > Projekt importieren.
   2. Gehen Sie zum Verzeichnis, 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 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 für die Autorisierung und Authentifizierung Ihres Spiels.

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

1. Rufen Sie in Ihrem 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 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 den Zweck 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 zur Verfügung stehen.
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 Erstellen signierter APKs in Android Studio können Sie einen neuen Schlüsselspeicher und ein signiertes Zertifikat generieren, falls Sie noch keinen haben. 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. Anwendungs-ID: Dies ist ein String, der nur aus zwölf Ziffern 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). Beim Testen oder Veröffentlichen Ihrer App sollten Sie dasselbe Zertifikat zum Signieren Ihrer App verwenden.
5. Konfiguriere 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	Das Ergebnis ist eine Primzahl.	–
      Atavismus	Fordern Sie einen Wert von 0 an.	–
      Bleib dran, Kind	Fordern Sie in jedem der Modi eine Punktzahl von 9999 an.	–
      OMG, ihr, UBER-LEET!	Er erhält eine Punktzahl von 1337.	Machen Sie diesen Erfolg als verborgenen Erfolg.
      Gelangweilt	Spielen Sie das Spiel 10 Mal.	Als inkrementellen Erfolg in 10 Schritten definieren
      Echt langweilig	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 für Ihr Spiel geeignet sind. Sehen Sie sich die Konzepte hinter den Erfolgen an und lesen Sie sich durch, wie Sie Erfolge in Android implementieren, um mehr zu erfahren.
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 „Easy Highscores“ und eine mit dem Namen „Hard High Scores“. Beide Bestenlisten sollten eine Punktzahlformatierung in Ganzzahlen und mit 0 Dezimalstellen haben und nach dem Sortiertyp Größer ist besser.
   3. Notieren Sie sich die IDs (lange alphanumerische Zeichenfolgen) für jede von Ihnen erstellte Bestenliste.
   4. Konfiguriere Bestenlisten, die zu deinem Spiel passen. Weitere Informationen finden Sie in den Konzepten hinter Bestenlisten. Wie Sie Bestenlisten in Android implementieren, erfahren Sie hier.
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 veröffentlicht wurde, können sich jedoch alle anmelden.

Warnung :Wenn Sie versuchen, Play Spiele SDK-Aufrufe für ein nicht veröffentlichtes Spiel zu senden, indem Sie ein Konto verwenden, das nicht als Testkonto aufgeführt ist, verhalten sich die Google Play-Spieldienste so, als wäre das Spiel nicht vorhanden. Sie erhalten dann den ConnectionResult.SIGN_IN_REQUIRED-Rückgabecode. Wenn Sie versuchen, ConnectionResult.startResolutionForResult() zu starten, erhalten Sie GamesActivityResultCodes.RESULT_SIGN_IN_FAILED.

Schritt 3: Code ändern

Um das Spiel auszuführen, müssen Sie die App-ID als Ressource in Ihrem Android-Projekt konfigurieren. Außerdem musst du in der AndroidManifest.xml Metadaten für Spiele 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 package-Attribut des Elements <manifest> ein. Wenn Sie ein Android-Spiel neu erstellen, müssen Sie außerdem 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

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

Hinweis :Es ist empfehlenswert, Tests auf einem Android-Gerät durchzuführen. Wenn Sie jedoch kein Gerät haben, können Sie Tests mit dem Android-Emulator durchführen. Laden Sie dazu unter Android 4.2.2 aus dem SDK-Manager das Emulator-System-Image herunter, das die Google Play-Dienste enthält.

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 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 APKs in Android Studio auf Erstellen > 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 über Android Studio ausführen, signiert Android Studio die App standardmäßig mit Ihrem Debug-Zertifikat. Wenn Sie dieses Debug-Zertifikat beim Einrichten der App in der Google Play Console nicht verwendet haben, treten Fehler auf. Führen Sie ein APK aus, das Sie exportiert und mit einem Zertifikat signiert haben, das einem der Zertifikate entspricht, die Sie bei der Einrichtung der App in der Google Play Console verwendet haben.