Autentica in Unity utilizzando i servizi per i giochi di Google Play

Puoi usare i servizi di Google Play Giochi per consentire ai giocatori di accedere a un gioco Android basate su Firebase e Unity. Per utilizzare l'accesso con Firebase ai servizi Google Play, innanzitutto fai accedere il giocatore a Google Play e richiedi un codice di autenticazione OAuth 2.0. Quindi, passa il codice di autenticazione a PlayGamesAuthProvider per generare una credenziale Firebase, che potrai utilizzare per autenticarti con Firebase.

Prima di iniziare

Configurare il progetto Unity

  1. Aggiungi il file di configurazione di Firebase e l'SDK Unity Firebase al tuo progetto Unity come descritto in Aggiungi Firebase al tuo progetto Unity. Segui le istruzioni per Android.

    Assicurati di importare FirebaseAuth.unitypackage.

  2. Nell'editor Unity, in Build Settings > (Impostazioni build >) Impostazioni del player > Altro Impostazioni imposta il nome del pacchetto Android del tuo gioco.

  3. Poi, in Impostazioni di compilazione > Impostazioni del player > Impostazioni di pubblicazione, seleziona o crea un keystore e una chiave, che verranno utilizzati per firmare il pacchetto Android. Affinché l'accesso a Play Giochi funzioni, l'APK deve essere firmato non si applica solo alla pubblicazione, ma anche durante lo sviluppo il tuo gioco.

Configura il progetto Firebase

  1. Nella console Firebase, vai al progetto Firebase in cui hai registrato il progetto Unity.

  2. Imposta la fingerprint SHA-1 del tuo gioco dalla pagina Impostazioni della console Firebase utilizzando la chiave impostata in Unity.

    Puoi ottenere l'impronta SHA-1 della tua chiave con il comando keytool: 

    keytool -exportcert -list -v \
    -alias YOUR-KEY-NAME -keystore PATH-TO-KEYSTORE

    In alternativa, puoi ottenere l'hash SHA del certificato di firma con comando gradle signingReport: 

    gradlew signingReport

    L'APK deve essere firmato con questa chiave, anche durante lo sviluppo.

  3. Attiva Google Play Games come provider di accesso:

    1. Nella console Firebase, apri il Sezione Authentication.

    2. Genera e ottieni l'ID client e il client secret del server web del tuo progetto:

      1. Nella scheda Metodo di accesso, attiva l'opzione Accedi con Google. o il provider di servizi di terze parti.

      2. Copia l'ID client e il secret del server web da Accedi con Google o il provider di servizi di terze parti.

    3. Nella scheda Metodo di accesso, attiva Play Games. di accesso e specificare l'ID client del server web e il client secret ottenuto nell'ultimo passaggio.

Configura Play Games services con le informazioni dell'app Firebase

  1. Nella Console Google Play, apri l'app Google Play o creane una.

  2. Nella sezione Crescita, fai clic su Play Games services > Configurazione e Gestione > Configurazione.

  3. Fai clic su Sì, il mio gioco utilizza già API di Google, seleziona il progetto Firebase dall'elenco e poi fai clic su Utilizza.

  4. Nella pagina di configurazione Play Games services, fai clic su Aggiungi credenziale.

    1. Seleziona il tipo Server di gioco.
    2. Nel campo Client OAuth, seleziona l'ID client web del progetto. Essere assicurati che sia lo stesso ID client specificato al momento dell'attivazione Accesso con Play Games.
    3. Salva le modifiche.

  5. Sempre nella pagina di configurazione di Play Games services, fai clic su Aggiungi credenziale di nuovo.

    1. Seleziona il tipo per Android.
    2. Nel campo Client OAuth, seleziona l'ID client Android del tuo progetto. Se non vedi il tuo ID client Android, assicurati di impostare il Impronta SHA-1 nella console Firebase.)
    3. Salva le modifiche.

  6. Nelle pagine Eventi, Obiettivi e Classifiche, crea un Play Games risorse da usare con il gioco (se non utilizzare immediatamente, puoi creare una voce segnaposto). Quindi, il giorno una delle pagine Eventi, Obiettivi o Classifiche, fai clic su Recupera le risorse e copia lo snippet delle risorse Android da qualche parte pratico. Ti servirà lo snippet per configurare Google Play Games services .

    Lo snippet delle risorse è simile all'esempio seguente:

    <?xml version="1.0" encoding="utf-8"?>
<!--
Google Play game services IDs.
Save this file as res/values/games-ids.xml in your project.
-->
<resources>
  <!-- app_id -->
  <string name="app_id" translatable="false">123456789000</string>
  <!-- package_name -->
  <string name="package_name" translatable="false">com.example.game</string>
  <!-- event Wiped Raid -->
  <string name="event_wiped_raid" translatable="false">CgkIpKjv1a4PEAIYBA</string>
</resources>

  7. Nella pagina Tester, aggiungi gli indirizzi email di tutti gli utenti che devono poter accedere al gioco prima di rilasciarlo sul Play Store.

Integra l'accesso di Play Giochi nel tuo gioco

  1. Scarica la versione più recente del plug-in Play Giochi per Unity ed estrailo.

  2. Importa il pacchetto Unity del plug-in nel tuo progetto Unity. Puoi trovare il pacchetto Unity nella directory current-build dell'archivio delle release.

  3. Configura il plug-in di Play Giochi:

    1. Fai clic su Finestra > Google Play Giochi > Configurazione > Configurazione di Android per aprire Schermata Android Configuration (Configurazione Android).
    2. Incolla lo snippet delle risorse Android ricevuto da Play Console in nel campo Definizione delle risorse.
    3. Incolla l'ID client del server web fornito al momento dell'attivazione Accedi a Play Giochi nella console Firebase, nell'ID client .
    4. Fai clic su Configurazione.

  4. Nel tuo gioco, configura un client Play Giochi con RequestServerAuthCode attivata:

    using GooglePlayGames;
using GooglePlayGames.BasicApi;
using UnityEngine.SocialPlatforms;
using System.Threading.Tasks;

PlayGamesClientConfiguration config = new PlayGamesClientConfiguration.Builder()
    .RequestServerAuthCode(false /* Don't force refresh */)
    .Build();

PlayGamesPlatform.InitializeInstance(config);
PlayGamesPlatform.Activate();

  5. Quando un giocatore sceglie di accedere con Play Giochi, chiama Social.localUser.Authenticate():

    Social.localUser.Authenticate((bool success) => {
  // handle success or failure
});

Esegui l'autenticazione con Firebase

Dopo aver aggiunto l'accesso a Play Giochi, puoi utilizzare il codice di autorizzazione di tramite i servizi per i giochi di Play per l'autenticazione con Firebase.

  1. Dopo che il giocatore ha eseguito l'accesso tramite Play Giochi, l'accesso continuation, ottieni un codice di autorizzazione per l'account del player:

    Social.localUser.Authenticate((bool success) => {
  if (success) {
    authCode = PlayGamesPlatform.Instance.GetServerAuthCode();
  }
});

  2. Quindi, sostituisci il codice di autorizzazione dei servizi Play Giochi con un codice Firebase e usa la credenziale Firebase per autenticare il giocatore:

    Firebase.Auth.FirebaseAuth auth = Firebase.Auth.FirebaseAuth.DefaultInstance;
Firebase.Auth.Credential credential =
    Firebase.Auth.PlayGamesAuthProvider.GetCredential(authCode);
auth.SignInAndRetrieveDataWithCredentialAsync(credential).ContinueWith(task => {
  if (task.IsCanceled) {
    Debug.LogError("SignInAndRetrieveDataWithCredentialAsync was canceled.");
    return;
  }
  if (task.IsFaulted) {
    Debug.LogError("SignInAndRetrieveDataWithCredentialAsync encountered an error: " + task.Exception);
    return;
  }

  Firebase.Auth.AuthResult result = task.Result;
  Debug.LogFormat("User signed in successfully: {0} ({1})",
      result.User.DisplayName, result.User.UserId);
});

Passaggi successivi

Dopo che un utente ha eseguito l'accesso per la prima volta, viene creato un nuovo account utente e collegati al suo ID Play Giochi. Il nuovo account è memorizzato come parte di progetto Firebase e può essere utilizzato per identificare un utente in ogni app progetto.

Nel gioco, puoi ottenere l'UID Firebase dell'utente Oggetto Firebase.Auth.FirebaseUser:

Firebase.Auth.FirebaseUser user = auth.CurrentUser;
if (user != null && user.IsValid()) {
  string playerName = user.DisplayName;

  // The user's Id, unique to the Firebase project.
  // Do NOT use this value to authenticate with your backend server, if you
  // have one; use User.TokenAsync() instead.
  string uid = user.UserId;
}

Nelle regole di sicurezza di Firebase Realtime Database e Cloud Storage, puoi recuperare l'ID utente univoco dell'utente che ha eseguito l'accesso dalla variabile auth e utilizzarlo per controllare i dati a cui un utente può accedere.

Per ottenere le informazioni del giocatore di Play Giochi di un utente o per accedere ai servizi di Play Giochi, utilizza le API fornite dal plug-in Play Giochi.

Per disconnettere un utente, chiama SignOut():

auth.SignOut();