Erste Schritte mit den Play-Spieldiensten für C und C++

In diesem Leitfaden wird beschrieben, wie Sie ein natives C- oder C++-Spielprojekt einrichten, um das native SDK für Play-Spieldienste v2 zu verwenden und den Anmeldedienst zu integrieren. Die Anmeldung muss eingebunden sein, damit Sie andere Funktionen der Play-Spieldienste in Ihr Spiel und die Play-Spieldienste in Ihren Backend-Gameserver einbinden können.

Unterstützte Funktionen

Das Native SDK für die Google Play-Spieldienste v2 befindet sich in der Betaphase und unterstützt nur den Anmeldedienst. Andere Funktionen der Play Spiele-Dienste werden noch nicht unterstützt.

API-Referenzdokumentation

Die Headerdateien für das SDK enthalten die Referenzdokumentation für die APIs. Die Headerdateien befinden sich in den SDK-Dateien im Ordner include. Sie sind verfügbar, nachdem Sie Ihr Projekt mit dem SDK-Repository synchronisiert haben.

Voraussetzungen

  • Ein Spielprojekt, bei dem C oder C++ als primäre Programmiersprache verwendet wird.

  • Für Ihr Spielprojekt und Ihre Entwicklungsumgebung muss das Gradle-Buildsystem eingerichtet sein.

Vorbereitung

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

Spielprojekt einrichten

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

CMakeLists.txt aktualisieren

Fügen Sie in Ihrer CMakeLists.txt-Datei 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)

build.gradle aktualisieren

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

  • Die Funktion zum Erstellen von Prefabs muss aktiviert sein.

  • Fügen Sie die Abhängigkeit für das native SDK der Play-Spieldienste v2 hinzu:

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

Beispiel:

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

AndroidManifest.xml aktualisieren

  1. Definieren Sie in der Datei AndroidManifest.xml die Projekt-ID Ihrer Play Games Services. Fügen Sie dazu in die Datei die folgenden Zeilen ein:

    <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 zum Zeitpunkt der Erstellung auf die ID zugreifen. Erstellen Sie zum Erstellen der Ressource 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 der Vorgang erfolgreich war, wird beim Starten Ihres Spiels eine Aufforderung zur Anmeldung oder ein Banner zur erfolgreichen Anmeldung angezeigt.

Spieler-ID abrufen

Ihr Spiel kann auf Spielerinformationen für einen angemeldeten Spieler zugreifen, indem die Spieler-ID abgerufen wird. Du kannst eine Spieler-ID abrufen, indem du die Funktion GetPlayerID aufrufst. Das wird im folgenden Beispiel veranschaulicht.

#include <assert.h>
#include "gni/gni.h"
#include "gni/gni_task.h"
#include "pgs/pgs_play_games.h"
#include "pgs/pgs_players_client.h"

// A callback for a GniTask returned from PgsPlayersClient_getCurrentPlayerId.
void OnGetCurrentPlayerIdCompleteCallback(GniTask *task, void *user_data) {

   if (!GniTask_isSuccessful(task)) {
      const char *error_message = nullptr;
      GniTask_getErrorMessage(task, &error_message);

      // Log error message here.

      GniString_destroy(error_message);
      GniTask_destroy(task);
      return;
   }

   const char *result = nullptr;
   PgsPlayersClient_getCurrentPlayerId_getResult(task, &result);

   // Log player id here.

   GniString_destroy(result);
   GniTask_destroy(task);
}

// Gets the player ID.
void GetPlayerId(jobject main_activity) {
   static const PgsPlayersClient *players_client =
           PgsPlayGames_getPlayersClient(main_activity);

   GniTask *get_current_player_id_task =
           PgsPlayersClient_getCurrentPlayerId(players_client);
   assert(get_current_player_id_task != nullptr);
   GniTask_addOnCompleteCallback(get_current_player_id_task,
                                 OnGetCurrentPlayerIdCompleteCallback,
                                 nullptr);
}

// Entry point for our test app
void TestPGSNative(JNIEnv *env, jobject main_activity) {
   JavaVM *java_vm;
   env->GetJavaVM(&java_vm);

   GniCore_init(java_vm, main_activity);

   GetPlayerId(main_activity);
}

Anmeldeaufforderung noch einmal anzeigen

Wenn ein Spieler die erste Aufforderung zur Anmeldung in den Play-Spieldiensten ablehnt, die beim Starten Ihres Spiels automatisch angezeigt wird, kann er während der Spielsitzung seine Meinung ändern. Du kannst die Anmeldeaufforderung noch einmal aufrufen, indem du PgsGamesSignInClient_signIn aufrufst, solange sich derzeit keine Spieler angemeldet haben.

Gameserver-Autorisierung

Sobald sich ein Spieler in den Play-Spieldiensten angemeldet hat, kann Ihr Game-Client einen Serverautorisierungscode anfordern, mit dem Ihr Backend-Game-Server sicher mit den Play-Spieldiensten kommunizieren kann. So kann Ihr Game-Server Daten für den angemeldeten Spieler abrufen, aktualisieren und speichern. Sie können den Autorisierungscode des Servers abrufen, indem Sie die Funktion PgsGamesSignInClient_requestServerSideAccess aufrufen.

Weitere Informationen finden Sie im Leitfaden zum Serverzugriff.