Konfigurowanie pakietu SDK usług Gier Play w wersji 2 w języku C lub C++

Z tego dokumentu dowiesz się, jak skonfigurować projekt w języku C++ na potrzeby pakietu SDK usług Gier Play w wersji 2 w języku C lub C++ i zweryfikować usługę uwierzytelniania.

Zanim rozpoczniesz

Musisz skonfigurować usługi Gier Play w Konsoli Google Play.

Wymagania wstępne dotyczące aplikacji

Sprawdź, czy w pliku kompilacji Twojej aplikacji znajdują się te wartości:

  • wartość minSdkVersion wynosząca co najmniej 19.
  • wartość compileSdkVersion wynosząca co najmniej 28.

Konfigurowanie projektu gry

Aby skonfigurować projekt gry, wykonaj te czynności.

Aktualizacja pliku build.gradle

W pliku build.gradle na poziomie aplikacji wykonaj te czynności:

  • Sprawdź, czy funkcja tworzenia gotowymi do użycia pakietami prefab jest włączona.

  • Dodaj zależność dla natywnego pakietu SDK w wersji 2 (beta):

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

Oto przykład:

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

Aktualizacja 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)

Aktualizacja pliku AndroidManifest.xml.

  1. Aby zdefiniować identyfikator projektu usług Gier Play w pliku AndroidManifest.xml, dodaj te wiersze:

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

  2. Dla identyfikatora projektu utwórz zasób w postaci ciągu znaków. Dzięki temu gra będzie miała dostęp do identyfikatora w momencie kompilacji. Aby utworzyć zasób, utwórz plik project_root/app/src/main/res/values/games-ids.xml i dodaj do niego te informacje:

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

  3. Stwórz i przetestuj grę. Jeśli to się uda, po uruchomieniu gry pojawi się prośba o zalogowanie lub baner informujący o pomyślnym zalogowaniu.

Ponowne wyświetlenie promptu logowania

Jeśli gracz odrzuci początkowy monit o zalogowanie się w usługach Gier Play, który wyświetla się automatycznie po uruchomieniu gry, może zmienić zdanie podczas sesji. Możesz ponownie wyświetlić prośbę o zalogowanie, wywołując funkcję PgsGamesSignInClient_signIn, o ile żaden gracz nie jest uwierzytelniony.

Autoryzacja serwera gry

Gdy gracz pomyślnie uwierzytelni się w usługach Gier Play, klient gry może poprosić o kod autoryzacji serwera, którego backendowy serwer gry może używać do bezpiecznej komunikacji z usługami Gier Play. Dzięki temu serwer gry może pobierać, aktualizować i przechowywać dane uwierzytelnionego gracza. Kod autoryzacji serwera możesz pobrać, wywołując funkcję PgsGamesSignInClient_requestServerSideAccess.

Więcej informacji znajdziesz w przewodniku po dostępie do serwera.