Questa pagina è stata tradotta dall'API Cloud Translation.

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

Puoi utilizzare i servizi Google Play Giochi per far accedere i giocatori a un gioco per Android sviluppato 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

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

Assicurati di importare FirebaseAuth.unitypackage.
In Unity Editor, in Impostazioni di compilazione > Impostazioni del player > Altre impostazioni, imposta il nome del pacchetto Android del tuo gioco.
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 Google Play Giochi funzioni, l'APK deve essere firmato. Questo requisito si applica non solo alla pubblicazione, ma anche durante lo sviluppo del gioco.

Configura il progetto Firebase

Nella console Firebase, vai al progetto Firebase in cui hai registrato il progetto Unity.
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 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 signingReport gradle:
```
gradlew signingReport
```
L'APK deve essere firmato con questa chiave, anche durante lo sviluppo.
Attiva Google Play Games come provider di accesso:
1. Nella console Firebase, apri la Authentication sezione.
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 fornitore di servizi di accesso Google.
  2. Copia l'ID client e il secret del server web dal fornitore 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 progetto che hai ottenuto nell'ultimo passaggio.

Configura Play Games services con le informazioni dell'app Firebase

Nella Console Google Play, apri l'app Google Play o creane una.
Nella sezione Crescita, fai clic su Play Games services > Configurazione e gestione > Configurazione.
Fai clic su Sì, il mio gioco utilizza già API di Google, seleziona il progetto Firebase dall'elenco e poi fai clic su Utilizza.
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 si tratti dello stesso ID client specificato quando hai attivato l'accesso con Play Games.
3. Salva le modifiche.
Sempre nella pagina di configurazione di Play Games services, fai nuovamente 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 il tuo ID cliente Android, assicurati di impostare l'impronta SHA-1 del tuo gioco nella console Firebase.
3. Salva le modifiche.

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 Ottieni risorse e copia lo snippet delle risorse Android in un punto comodo. Lo snippet ti servirà 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>

Nella pagina Tester, aggiungi gli indirizzi email di tutti gli utenti che devono poter accedere al tuo gioco prima di pubblicarlo suPlay Store.

Integrare l'accesso tramite Play Giochi nel gioco

Scarica la versione più recente del plug-in Play Giochi per Unity ed estrailo.
Importa il pacchetto Unity del plug-in nel tuo progetto Unity. Puoi trovare il pacchetto Unity nella directory current-build dell'archivio delle release.
Configura il plug-in Play Giochi:
1. Fai clic su Finestra > Google Play Giochi > 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 risorse.
3. Incolla l'ID client del tuo server web, che hai fornito quando hai attivato l'accesso a Google Play nella console Firebase, nel campo ID client.
4. Fai clic su Configurazione.

Nel tuo gioco, configura un client Play Giochi 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();

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 al tuo gioco, puoi utilizzare il codice di autenticazione dei servizi per i giochi di Play per autenticarti con Firebase.

Dopo che il giocatore ha eseguito l'accesso utilizzando Play Giochi, nel gestore di continuazione dell'accesso, ottieni un codice di autenticazione per l'account del giocatore:
```
Social.localUser.Authenticate((bool success) => {
  if (success) {
    authCode = PlayGamesPlatform.Instance.GetServerAuthCode();
  }
});
```

Poi, scambia il codice di autenticazione dei servizi per i giochi di Google Play con una credenziale Firebase e utilizzala 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 accede per la prima volta, viene creato un nuovo account utente e collegato al suo ID di Google Play. Questo nuovo account viene archiviato nel progetto Firebase e può essere utilizzato per identificare un utente in ogni app del progetto.

Nel tuo gioco, puoi recuperare 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 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 scollegare un utente, chiama SignOut():

auth.SignOut();