In dieser Anleitung wird beschrieben, wie Sie ein natives C- oder C++-Spielprojekt einrichten, um das native SDK der Play-Spieldienste v2 zu verwenden und den Anmeldedienst zu integrieren. Die Integration der Anmeldung ist erforderlich, um andere Funktionen der Play-Spieldienste in dein Spiel und die Play-Spieldienste in deinen Back-End-Spieleserver zu integrieren.
Unterstützte Funktionen
Das native SDK der Play-Spieldienste v2 befindet sich in der Betaphase und unterstützt nur den Anmeldedienst. Andere Funktionen der Play-Spieldienste werden noch nicht unterstützt.
API-Referenzdokumentation
Die Headerdateien für das SDK enthalten eine Referenzdokumentation für die APIs. Die Headerdateien befinden sich im Ordner include
in den SDK-Dateien, die nach der Synchronisierung Ihres Projekts mit dem SDK-Repository verfügbar sind.
Voraussetzungen
Ein Spielprojekt, das natives C oder C++ als primäre Programmiersprache verwendet.
In Ihrem Spielprojekt und Ihrer Entwicklungsumgebung muss das Gradle-Build-System eingerichtet sein.
Vorbereitung
Du musst in der Google Play Console Play-Spieldienste einrichten.
Spielprojekt einrichten
Führe die folgenden Schritte aus, um dein Spielprojekt einzurichten.
CMakeLists.txt aktualisieren
Fügen Sie in die Datei CMakeLists.txt
den folgenden Code ein:
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-Datei aktualisieren
Führen Sie in der Datei build.gradle
auf App-Ebene folgende Schritte aus:
Achten Sie darauf, dass das Build-Feature prefab aktiviert ist.
Fügen Sie die Abhängigkeit für das native SDK der Version 2 der Play-Spieldienste 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
Definiere in der Datei
AndroidManifest.xml
deine Play-Spieldienste-Projekt-ID. Fügen Sie dazu der Datei 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>
Erstellen Sie eine String-Ressource für Ihre Projekt-ID. Dadurch kann dein Spiel bei 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>
Erstelle und teste dein Spiel. Wenn der Vorgang erfolgreich war, wird beim Starten des Spiels eine Anmeldeaufforderung oder ein Banner zur Anmeldung angezeigt.
Spieler-ID abrufen
Ihr Spiel kann durch Abrufen seiner Spieler-ID auf Spielerinformationen eines angemeldeten Spielers zugreifen. Du kannst eine Spieler-ID abrufen, indem du die Funktion GetPlayerID
aufrufst, die im folgenden Beispiel veranschaulicht wird.
#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);
}
Aufforderung zur Anmeldung neu starten
Wenn ein Spieler die anfängliche Aufforderung zur Anmeldung in den Play-Spieldiensten ablehnt, die beim Start Ihres Spiels automatisch angezeigt wird, kann er während der Spielsitzung seine Meinung ändern. Sie können die Aufforderung zur Anmeldung durch Aufrufen von PgsGamesSignInClient_signIn
neu starten, solange keine Spieler angemeldet sind.
Gameserver-Autorisierung
Sobald sich ein Spieler erfolgreich in den Play-Spieldiensten anmeldet, kann Ihr Spieleclient einen Serverautorisierungscode anfordern, mit dem Ihr Back-End-Spieleserver sicher mit den Play-Spieldiensten kommunizieren kann. Dadurch kann dein Spieleserver Daten für den angemeldeten Spieler abrufen, aktualisieren und speichern. Sie können den Serverautorisierungscode abrufen, indem Sie die Funktion PgsGamesSignInClient_requestServerSideAccess
aufrufen.
Weitere Informationen finden Sie im Leitfaden für den Serverzugriff.