Google 致力于为黑人社区推动种族平等。查看具体举措

Autenticati in Unity utilizzando i servizi di giochi di Google Play

Puoi utilizzare i servizi di Google Play Games 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 quando lo fai. Quindi, passa il codice di autenticazione a PlayGamesAuthProvider per generare una credenziale Firebase, che puoi utilizzare per autenticarti con Firebase.

Prima di iniziare

Configura il tuo 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 di Unity, in Impostazioni build > Impostazioni giocatore > Altre impostazioni , imposta il nome del pacchetto Android del tuo gioco.

  3. Quindi, in Impostazioni build > Impostazioni giocatore > 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 Giochi funzioni: questo requisito si applica non solo alla pubblicazione, ma anche durante lo sviluppo del gioco.

Configura il tuo progetto Firebase

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

  2. Imposta l'impronta digitale SHA-1 del tuo gioco dalla pagina Impostazioni della console Firebase, utilizzando la chiave che hai 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

    Il tuo 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 e il segreto client del tuo progetto. 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 da Google Service) . Questa pagina elenca l'ID client e il segreto del tuo server web.
    2. Quindi, nella console Firebase , apri la sezione Autenticazione .

    3. Nella scheda Metodo di accesso, abilita il provider di accesso a Play Giochi . Dovrai specificare l'ID client del server Web del tuo progetto e il client secret, che hai ottenuto dalla console delle API.

Configura i servizi di Play Games con le informazioni dell'app Firebase

  1. In Google Play Console , apri la tua app Google Play o creane una.

  2. Nella sezione Cresci , fai clic su Servizi di Play Games > 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, quindi fai clic su Usa .

  4. Nella pagina di configurazione dei servizi di Play Games, fai clic su Aggiungi credenziali .

    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 che hai specificato quando hai abilitato l'accesso a Play Giochi.
    3. Salva le modifiche.
  5. Sempre nella pagina di configurazione dei servizi di Play Games, fai nuovamente clic su Aggiungi credenziali .

    1. Seleziona il tipo di 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 l'impronta digitale SHA-1 del tuo gioco nella console Firebase.)
    3. Salva le modifiche.
  6. Nelle pagine Eventi , Obiettivi e Classifiche , crea le risorse di Play Games che desideri utilizzare con il tuo gioco (se non desideri utilizzarle immediatamente, puoi creare una voce segnaposto). Quindi, in una qualsiasi delle pagine Eventi , Obiettivi o Classifiche , fai clic su Ottieni risorse e copia lo snippet delle risorse Android in un punto conveniente. Avrai bisogno dello snippet per configurare il plug-in dei servizi di Google Play Games.

    Il frammento 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 Tester , aggiungi gli indirizzi email di tutti gli utenti che devono poter 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 estrailo.

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

  3. Configura il plug-in Play Giochi:

    1. Fare clic su Finestra > Google Play Games > Configurazione > Configurazione Android per aprire la schermata Configurazione Android .
    2. Incolla lo snippet di risorse Android che hai ricevuto dalla console di Play nel campo Definizione risorse .
    3. Incolla l'ID client del tuo server web, che hai fornito quando hai abilitato l'accesso a Play Giochi nella console Firebase, nel campo ID client .
    4. Fare clic su Configurazione .
  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
    });
    

Autenticati con Firebase

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

  1. Dopo che il giocatore ha eseguito 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 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.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 suo ID Play Games. Questo nuovo account viene archiviato come parte del 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) {
  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 del database in tempo reale e dell'archiviazione cloud di Firebase, 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 Games di un utente o per accedere ai servizi di Play Games, utilizza le API fornite dal plug-in Play Games.

Per disconnettere un utente, chiama SignOut() :

auth.SignOut();