Configurare v2 Native C o C++

Questo documento ti aiuta a configurare il progetto C++ per Native C o C++ v2 e a verificare il servizio di autenticazione.

Prima di iniziare

Devi configurare Play Games Services in Google Play Console.

Prerequisiti dell'app

Assicurati che il file di build dell'app utilizzi i seguenti valori:

  • Un minSdkVersion di 19 o versioni successive
  • Un compileSdkVersion di 28 o versioni successive

Configura il progetto di gioco

Completa i seguenti passaggi per configurare il progetto di gioco.

Aggiorna build.gradle

Nel file build.gradle a livello di app, procedi nel seguente modo:

  • Assicurati che la funzionalità di creazione di prefab sia attiva.

  • Aggiungi la dipendenza per l'SDK Native v2 (beta):

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

Ecco un esempio:

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

Aggiorna CMakeLists.txt

Nel file CMakeLists.txt, aggiungi il seguente codice:

  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)

Carica il file AndroidManifest.xml

  1. Per definire l'ID progetto di Play Games Services nel file AndroidManifest.xml, aggiungi le seguenti righe:

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

  2. Crea una risorsa stringa per l'ID progetto. In questo modo, il gioco può accedere all'ID in fase di compilazione. Per creare la risorsa, crea il file project_root/app/src/main/res/values/games-ids.xml e aggiungi quanto segue:

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

  3. Crea e testa il tuo gioco. Se l'operazione va a buon fine, all'avvio del gioco viene visualizzato un prompt di accesso o un banner di accesso riuscito.

Riavvia la richiesta di accesso

Se un giocatore rifiuta la richiesta di accesso iniziale a Play Games Services visualizzata automaticamente all'avvio del gioco, potrebbe cambiare idea durante la sessione di gioco. Puoi riavviare la richiesta di accesso chiamando la funzione PgsGamesSignInClient_signIn purché nessun giocatore sia autenticato.

Autorizzazione del server di gioco

Una volta che un giocatore si autentica correttamente ai Play Games Services, il client di gioco può richiedere un codice di autorizzazione del server che il server di gioco di backend può utilizzare per comunicare in modo sicuro con i Play Games Services. In questo modo, il server di gioco può recuperare, aggiornare e archiviare i dati del giocatore autenticato. Puoi recuperare il codice di autorizzazione del server chiamando la funzione PgsGamesSignInClient_requestServerSideAccess.

Per ulteriori informazioni, consulta la guida all'accesso al server.