Native C- oder C++-Version 2 einrichten

In diesem Dokument erfahren Sie, wie Sie Ihr C++-Projekt für die Version 2 des nativen C- oder C++-SDK einrichten und den Authentifizierungsdienst überprüfen.

Vorbereitung

Sie müssen die Play Games-Dienste in der Google Play Console einrichten.

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

Spielprojekt einrichten

Führen Sie die folgenden Schritte aus, um Ihr Spielprojekt einzurichten.

build.gradle aktualisieren

Führen Sie in der Datei build.gradle auf App-Ebene die folgenden Schritte aus:

  • Achten Sie darauf, dass die Prefab-Build-Funktion aktiviert ist.

  • Fügen Sie die Abhängigkeit für das native SDK der Version 2 (Beta) hinzu:

    • com.google.android.gms:play-services-games-v2-native-c:21.0.0-beta1

Beispiel:

  android {
    ...
    buildFeatures {
      prefab true
    }
    ...
  }
  dependencies {
    ...
    implementation "com.google.android.gms:play-services-games-v2-native-c:21.0.0-beta1"
  }

CMakeLists.txt aktualisieren

Fügen Sie der Datei CMakeLists.txt den folgenden Code hinzu:

  find_package(com.google.android.gms.games.v2.c REQUIRED CONFIG)

  // link games_static for -DANDROID_STL=c++_static or default
  // link games_shared for -DANDROID_STL=c++_shared
  target_link_libraries(
    app PUBLIC com.google.android.gms.games.v2.c::games_static)

AndroidManifest.xml aktualisieren

  1. Wenn Sie die Projekt-ID der Play Games-Dienste in der Datei AndroidManifest.xml definieren möchten, fügen Sie die folgenden Zeilen hinzu:

    <manifest>
  <application>
    <meta-data android:name="com.google.android.gms.games.APP_ID"
               android:value="@string/game_services_project_id"/>
  </application>
</manifest>

  2. Erstellen Sie eine Stringressource für Ihre Projekt-ID. So kann Ihr Spiel zur Build-Zeit auf die ID zugreifen. Erstellen Sie dazu die Datei project_root/app/src/main/res/values/games-ids.xml, und fügen Sie Folgendes hinzu:

    <?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="game_services_project_id"
            translatable="false">add your Project ID here</string>
</resources>

  3. Erstellen und testen Sie Ihr Spiel. Wenn alles funktioniert, wird beim Starten des Spiels eine Anmeldeaufforderung oder ein Banner mit der Meldung angezeigt, dass die Anmeldung erfolgreich war.

Anmeldeaufforderung neu starten

Wenn ein Spieler die erste Anmeldeaufforderung für die Play Games-Dienste ablehnt, die beim Starten des Spiels automatisch angezeigt wird, kann er seine Meinung während der Spielsitzung ändern. Sie können die Anmeldeaufforderung neu starten, indem Sie PgsGamesSignInClient_signIn aufrufen, solange keine Spieler authentifiziert sind.

Gameserver-Autorisierung

Sobald sich ein Spieler erfolgreich bei den Play Games-Diensten authentifiziert hat, kann der Spielclient einen Serverautorisierungscode anfordern, mit dem der Backend-Gameserver sicher mit den Play Games-Diensten kommunizieren kann. So kann der Gameserver Daten für den authentifizierten Spieler abrufen, aktualisieren und speichern. Sie können den Serverautorisierungscode mit der Funktion PgsGamesSignInClient_requestServerSideAccess abrufen.

Weitere Informationen finden Sie im Leitfaden zum Serverzugriff.