Z tego przewodnika dowiesz się, jak skonfigurować projekt gry w języku C lub C++, by użyć natywnego pakietu SDK usług gier Play w wersji 2 i zintegrować usługę logowania. Integracja logowania jest wymagana, aby można było zintegrować z grą inne funkcje usług gier Play i zintegrować te usługi z serwerem gry backendu.
Obsługiwane funkcje
Natywny pakiet SDK Usług gier Play w wersji 2 jest w wersji beta i obsługuje tylko usługę logowania. Nie obsługuje jeszcze innych funkcji usług gier Play.
Dokumentacja API
Pliki nagłówka pakietu SDK zawierają dokumentację interfejsów API. Pliki nagłówka znajdują się w folderze include
w plikach SDK, które są dostępne po zsynchronizowaniu projektu z repozytorium SDK.
Wymagania
Projekt gry, w którym głównym językiem programowania jest natywny język C lub C++.
W projekcie i środowisku programistycznym gry musi być skonfigurowany system kompilacji Gradle.
Zanim zaczniesz
Musisz skonfigurować usługi gier Play w Konsoli Google Play.
Konfigurowanie projektu gry
Aby skonfigurować projekt gry, wykonaj te czynności.
Aktualizowanie pliku CMakeLists.txt
W pliku CMakeLists.txt
dodaj ten kod:
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)
Aktualizowanie pliku build.gradle
W pliku build.gradle
na poziomie aplikacji wykonaj te czynności:
Upewnij się, że funkcja kompilacji prefab jest włączona.
Dodaj zależność z natywnym pakietem SDK usług gier Play w wersji 2:
com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1
Oto przykład:
android {
...
buildFeatures {
prefab true
}
...
}
dependencies {
...
implementation "com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1"
}
Aktualizacja pliku AndroidManifest.xml
W pliku
AndroidManifest.xml
zdefiniuj identyfikator projektu w usługach gier Play. Aby to zrobić, dodaj do pliku te wiersze:<manifest> <application> <meta-data android:name="com.google.android.gms.games.APP_ID" android:value="@string/game_services_project_id"/> </application> </manifest>
Utwórz zasób w postaci ciągu znaków dla identyfikatora projektu. Dzięki temu gra będzie mieć dostęp do tego identyfikatora w czasie kompilacji. Aby utworzyć zasób, utwórz plik
project_root/app/src/main/res/values/games-ids.xml
i dodaj:<?xml version="1.0" encoding="utf-8"?> <resources> <string name="game_services_project_id" translatable="false">add your Project ID here</string> </resources>
Stwórz i przetestuj swoją grę. Jeśli się uda, po uruchomieniu gry pojawi się prośba o zalogowanie się lub baner informujący o powodzeniu logowania.
Uzyskaj identyfikator odtwarzacza
Twoja gra może uzyskać dostęp do informacji o zalogowanego gracza, pobierając jego identyfikator. Identyfikator gracza możesz pobrać, wywołując funkcję GetPlayerID
, co pokazano w tym przykładzie.
#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);
}
Uruchom ponownie prośbę o zalogowanie
Jeśli gracz odrzuci początkową prośbę o zalogowanie się w usługach gier Play, która wyświetla się automatycznie po uruchomieniu gry, może zmienić zdanie w trakcie sesji gry. Możesz ponownie uruchomić prośbę o zalogowanie się, wywołując PgsGamesSignInClient_signIn
, dopóki nie jest zalogowany żaden gracz.
Autoryzacja serwera gier
Gdy gracz zaloguje się w usługach gier Play, klient gry może zażądać kodu autoryzacji serwera, za pomocą którego serwer gry backendu może bezpiecznie komunikować się z tymi usługami. Dzięki temu serwer gier może pobierać, aktualizować i przechowywać dane zalogowanego gracza. Kod autoryzacji serwera możesz pobrać, wywołując funkcję PgsGamesSignInClient_requestServerSideAccess
.
Więcej informacji znajdziesz w przewodniku po dostępie do serwera.