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

Puoi utilizzare i servizi per i giochi di Google Play per consentire ai giocatori di accedere a un gioco per Android creato su Firebase e Unity. Per utilizzare l'accesso ai servizi Google Play Giochi con Firebase, accedi prima al giocatore con Google Play Giochi e richiedi un codice di autorizzazione OAuth 2.0. Quindi, passa il codice di autorizzazione a PlayGamesAuthProvider per generare una credenziale Firebase, che puoi utilizzare per l'autenticazione con Firebase.

Prima di iniziare

Configura il progetto Unity

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

   Assicurati di importare FirebaseAuth.unitypackage.

2. Nell'editor Unity, in Build Settings > Player Settings > Other Settings (Impostazioni di build > Impostazioni del giocatore > Altre impostazioni), imposta il nome del pacchetto Android del tuo gioco.

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

Configura il progetto Firebase

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

2. Specifica l'impronta SHA-1 del tuo gioco.

   1. Nella console Firebase, vai a settings Impostazioni > scheda Generale.

   2. Scorri verso il basso fino alla scheda Le tue app, seleziona la tua app per Android e aggiungi l'impronta SHA-1 nel campo Impronte digitali certificato SHA.

   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 il comando gradle signingReport:

   gradlew signingReport

   Per informazioni dettagliate su come ottenere l'impronta SHA della tua app, consulta Autenticazione del client.

   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, vai a Sicurezza > Autenticazione.

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

      1. Nella scheda Metodo di accesso, attiva il provider di accesso Google.

      2. Copia l'ID client e il client secret del server web dal provider di accesso Google.

   3. Nella scheda Metodo di accesso, attiva il provider di accesso Play Games e specifica l'ID client e il client secret del server web del tuo progetto, che hai ottenuto nell'ultimo passaggio.

Configura Play Games services con le informazioni della tua app Firebase

1. Nella Google Play Console, 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à le API di Google, seleziona il tuo progetto Firebase dall'elenco e poi fai clic su Utilizza.

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

   1. Seleziona il tipo di server di gioco.
   2. Nel campo Client OAuth, seleziona l'ID client web del tuo progetto. Assicurati che sia lo stesso ID client specificato quando hai attivato l'accesso Play Games.
   3. Salva le modifiche.

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

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

6. Nelle pagine Eventi, Obiettivi e Classifiche, crea le risorse Play Games che vuoi utilizzare con il tuo gioco (se non vuoi utilizzarne subito, puoi creare una voce segnaposto). Poi, in una delle pagine Eventi, Obiettivi o Classifiche, fai clic su Scarica risorse e copia lo snippet delle risorse Android in un punto comodo. Avrai bisogno dello snippet per configurare il plug-in Google Play Games services.

   Lo snippet delle risorse è simile al seguente esempio:

   <?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 tuo gioco prima che venga rilasciato su Play Store.

Integrare l'accesso a Play Games nel tuo gioco

1. Scarica l'ultima versione del plug-in Play Giochi per Unity ed estraila.

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 Play Games:

   1. Fai clic su Finestra > Google Play Games > Configurazione > Configurazione Android per aprire la schermata Configurazione Android.
   2. Incolla lo snippet delle risorse Android che hai ottenuto da Play Console nel campo Definizione delle risorse.
   3. Incolla l'ID client del server web, che hai fornito quando hai attivato l'accesso con Play Giochi nella console Firebase, nel campo ID client.
   4. Fai clic su Configurazione.

4. Nel tuo gioco, configura un client Play Games con l'impostazione 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. Poi, quando un giocatore sceglie di accedere con Play Giochi, chiama Social.localUser.Authenticate():

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

Autenticarsi con Firebase

Dopo aver aggiunto l'accesso con Play Games al tuo gioco, puoi utilizzare il codice di autorizzazione dei servizi Play Games per l'autenticazione con Firebase.

1. Dopo che il giocatore ha eseguito l'accesso correttamente utilizzando Play Giochi, nel gestore di continuazione dell'accesso, ottieni un codice di autorizzazione per l'account del giocatore:

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

2. Quindi, scambia il codice di autenticazione dei servizi per i giochi di Play con una credenziale Firebase e utilizza 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 il primo accesso di un utente, viene creato un nuovo account utente e collegato al suo ID Play Giochi. Questo nuovo account viene memorizzato nel tuo progetto Firebase e può essere utilizzato per identificare un utente in ogni app del tuo progetto.

Nel tuo gioco, puoi ottenere l'UID Firebase dell'utente dall'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 ottenere l'ID utente univoco dell'utente che ha eseguito l'accesso dalla variabile auth e utilizzarlo per controllare a quali dati può accedere un utente.

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

Per disconnettere un utente, chiama SignOut():

auth.SignOut();