Google si impegna a promuovere l'equità razziale per le comunità nere. Vedi come.
Questa pagina è stata tradotta dall'API Cloud Translation.
Switch to English

Autenticare in Unity utilizzando Google Play Games Services

Puoi utilizzare i servizi di Google Play Giochi per accedere ai giocatori a un gioco Android basato su Firebase e Unity. Per utilizzare i servizi di Google Play Games accedi con Firebase, accedi prima al lettore con Google Play Games e richiedi un codice di autenticazione OAuth 2.0. Quindi, passa il codice di autenticazione a PlayGamesAuthProvider per generare una credenziale Firebase, che puoi utilizzare per autenticarti con Firebase.

Prima di iniziare

Imposta Unity

  1. Aggiungi il file di configurazione di Firebase e l'SDK di Firebase Unity 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 Impostazioni build> Impostazioni giocatore> Altre impostazioni imposta il nome del pacchetto Android del gioco.

  3. Quindi, in Impostazioni build> Impostazioni lettore> Impostazioni pubblicazione , seleziona o crea un keystore e una chiave, che verranno utilizzati per firmare il tuo pacchetto Android. L'APK deve essere firmato affinché l'accesso a Play Games funzioni, questo requisito si applica non solo alla pubblicazione, ma anche durante lo sviluppo del gioco.

Configura il tuo progetto Firebase

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

  2. Imposta l'impronta digitale SHA-1 del gioco dalla pagina Impostazioni della console di Firebase, utilizzando il tasto impostato in Unity.

    Puoi ottenere l'impronta digitale 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 tuo certificato di firma con il comando Gradle signingReport :

    gradlew signingReport

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

  3. Abilita Google Play Games come provider di accesso:

    1. Trova l'ID client del server web del progetto e il segreto client. L'ID client del server Web identifica il tuo progetto Firebase sui server di autenticazione di Google Play.

      Per trovare questi valori:

      1. Apri il tuo progetto Firebase nella pagina delle credenziali della console delle API di Google .
      2. Nella sezione ID client OAuth 2.0 , apri la pagina dei dettagli del client Web (creato automaticamente dal servizio Google) . Questa pagina elenca l'ID client e il segreto del server Web.
    2. Quindi, nella console di Firebase , apri la sezione Autenticazione .

    3. Nella scheda Metodo di accesso , abilitare il provider di accesso a Play Games . Dovrai specificare l'ID client del server web del progetto e il segreto client, ottenuti dalla console delle API.

  1. Apri la console di Google Play e fai clic su Servizi giochi .

  2. Fai clic su Aggiungi nuovo gioco . Nella finestra di dialogo del nuovo gioco, fai clic su Utilizzo già API di Google nel mio gioco e fai clic sul nome del tuo progetto Firebase nell'elenco. Seleziona una categoria di gioco, quindi fai clic su Continua per accedere alla pagina Dettagli gioco.

  3. Alla fine della pagina Dettagli gioco, assicurati che tutte le API richieste siano abilitate.

  4. Quindi, apri la pagina App collegate e fai clic su Android . Specifica il nome del pacchetto del gioco e fai clic su Salva e continua . La console visualizzerà il tuo ID client Android. Puoi ignorare questo valore.

  5. Apri di nuovo la pagina delle app collegate e fai clic su Collega un'altra app> Web . Utilizzerai questa pagina per consentire a Firebase Auth di recuperare i token di autenticazione da Google Play.

    Nel campo URL di avvio , specifica qualsiasi URL che controlli, ad esempio uno che utilizza il tuo dominio firebaseapp.com : https://myfirebaseproject-1ac49.firebaseapp.com/ . Questo URL non deve essere valido, ma è necessario specificare un valore diverso da localhost .

    Quindi, nella pagina successiva, fai clic su Mostra app e seleziona e seleziona l'ID client del tuo server web. L'ID client del tuo server web avrà un URI di reindirizzamento simile a https://myfirebaseproject-1ac49.firebaseapp.com/__/auth/handler .

  6. Nelle pagine Eventi , Obiettivi e Classifiche , crea tutte le risorse di Play Giochi che desideri utilizzare con il tuo gioco (se non vuoi usarne immediatamente, puoi creare una voce segnaposto). Quindi, nelle pagine Eventi , Obiettivi o Classifiche , fai clic su Ottieni risorse e copia lo snippet di risorse Android in un luogo comodo. È necessario lo snippet per configurare il plug-in dei servizi di Google Play Games.

    Lo snippet di 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 Test , autorizza gli indirizzi email di tutti gli utenti che devono essere in grado di accedere al tuo gioco prima di rilasciarlo sul Play Store.

Integra l'accesso a Play Games nel tuo gioco

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

  2. Importa il pacchetto Unity del plugin nel tuo progetto Unity. È possibile trovare il pacchetto Unity nella directory current-build dell'archivio delle versioni.

  3. Imposta il plug-in Play Games:

    1. Fai clic su Finestra> Google Play Giochi> Configurazione> Configurazione Android per aprire la schermata Configurazione Android .
    2. Incolla lo snippet di risorse Android ottenuto dalla console di riproduzione nel campo Definizione risorse .
    3. Incolla l'ID client del tuo server web, che hai fornito quando hai abilitato l'accesso a Play Games nella console di Firebase, nel campo ID client .
    4. Fai clic su Imposta .
  4. Nel gioco, configura un client Play Games con l'impostazione RequestServerAuthCode abilitata:

     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. Quindi, quando un giocatore sceglie di accedere con Play Games, chiama Social.localUser.Authenticate() :

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

Autenticare con Firebase

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

  1. Dopo che il giocatore ha effettuato correttamente l'accesso utilizzando Play Games, nel gestore della continuazione dell'accesso, ottieni un codice di autenticazione per l'account del giocatore:

     Social.localUser.Authenticate((bool success) => {
      if (success) {
        authCode = PlayGamesPlatform.Instance.GetServerAuthCode();
      }
    });
     
  2. Quindi, scambia il codice di autenticazione dai servizi di Play Games con una credenziale di Firebase e usa le credenziali di Firebase per autenticare il giocatore:

     Firebase.Auth.FirebaseAuth auth = Firebase.Auth.FirebaseAuth.DefaultInstance;
    Firebase.Auth.Credential credential =
        Firebase.Auth.PlayGamesAuthProvider.GetCredential(authCode);
    auth.SignInWithCredentialAsync(credential).ContinueWith(task => {
      if (task.IsCanceled) {
        Debug.LogError("SignInWithCredentialAsync was canceled.");
        return;
      }
      if (task.IsFaulted) {
        Debug.LogError("SignInWithCredentialAsync encountered an error: " + task.Exception);
        return;
      }
    
      Firebase.Auth.FirebaseUser newUser = task.Result;
      Debug.LogFormat("User signed in successfully: {0} ({1})",
          newUser.DisplayName, newUser.UserId);
    });
     

Prossimi passi

Dopo che un utente accede per la prima volta, viene creato un nuovo account utente e collegato al proprio ID Play Games. Questo nuovo account viene archiviato come parte del progetto Firebase e può essere utilizzato per identificare un utente in ogni app del 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) {
  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, è possibile ottenere l'ID utente univoco dell'utente connesso dalla variabile auth e utilizzarlo per controllare a quali dati può accedere un utente.

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

Per disconnettere un utente, chiamare SignOut() :

 auth.SignOut();