Aggiungi Firebase al tuo progetto Unity

Potenzia i tuoi giochi Unity con i nostri SDK Unity Firebase.

Per mostrarti quanto sia facile collegare Firebase al tuo progetto Unity, abbiamo creato una esempio del gioco MechaHamster. Se vuoi provare ad aggiungere Firebase a un gioco, utilizza la versione iniziale disponibile su GitHub. Se vuoi una versione completa, dai un'occhiata alle versioni nell'App Store o su Google Play Store.

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (Play Store)


Scopri di più su come migliorare i tuoi giochi con Firebase nella nostra pagina Firebase Games.

Hai già aggiunto Firebase al tuo progetto Unity? Assicurati di utilizzare l'ultima versione dell'SDK Firebase Unity.

Prerequisiti

  • Installa Unity 2021 LTS o versioni successive. Il supporto per Unity 2020 viene preso in considerazione sono deprecati e non saranno più supportati attivamente dopo la . Anche le versioni precedenti potrebbero essere compatibili, ma non saranno supportate attivamente.

  • (Solo piattaforme Apple) Installa quanto segue:

    • Xcode 13.3.1 o successivo
    • CocoaPods 1.12.0 o versioni successive

  • Assicurati che il progetto Unity soddisfi questi requisiti:

    • Per iOS: target iOS 13 o versioni successive
    • Per tvOS: ha come target tvOS 13 o versioni successive
    • Per Android: ha come target il livello API 21. (Lollipop) o versione successiva

  • Configura un dispositivo fisico o utilizza un emulatore per eseguire l'app.

    • Per le piattaforme Apple: configura un dispositivo fisico o utilizza un simulatore iOS o tvOS.

    • Per Android: Gli emulatori devono utilizzare un'opzione dell'emulatore con Google Play.

Se non hai ancora un progetto Unity e vuoi solo provare un prodotto Firebase, puoi scaricare uno dei nostri esempi della guida rapida.

Passaggio 1: crea un progetto Firebase

Prima di poter aggiungere Firebase al tuo progetto Unity, devi creare un account Firebase per connetterti al tuo progetto Unity. Visita la pagina Informazioni sui progetti Firebase per saperne di più di progetti Firebase.

Passaggio 2: registra la tua app con Firebase

Puoi registrare uno o più giochi o app da collegare a Firebase progetto.

  1. Vai alla console Firebase.

  2. Al centro della pagina Panoramica del progetto, fai clic sull'icona Unity () per avviare il flusso di lavoro di configurazione.

    Se hai già aggiunto un'app al tuo progetto Firebase, fai clic su Aggiungi app. per visualizzare le opzioni della piattaforma.

  3. Seleziona la destinazione di build del tuo progetto Unity che vuoi registrare oppure puoi anche selezionare la registrazione di entrambe le destinazioni contemporaneamente.

  4. Inserisci gli ID specifici della piattaforma del progetto Unity.

    • Per iOS: inserisci l'ID iOS del tuo progetto Unity nel ID gruppo iOS.

    • Per Android: inserisci l'ID Android del progetto Unity nella Pacchetto Android .
      I termini nome del pacchetto e ID applicazione vengono spesso utilizzati in modo intercambiabile.

  5. (Facoltativo) Inserisci i nickname specifici della piattaforma per il progetto Unity.
    Questi nickname sono identificatori di convenienza interni e sono visibili solo nella console Firebase.

  6. Fai clic su Registra app.

Passaggio 3: aggiungi i file di configurazione Firebase

  1. Ottieni i file di configurazione di Firebase specifici della piattaforma nel Firebase flusso di lavoro di configurazione della console.

    • Per iOS: fai clic su Scarica GoogleService-Info.plist.

    • Per Android: fai clic su Scarica google-services.json.

  2. Apri la finestra Project (Progetto) del progetto Unity, quindi sposta i file di configurazione nella cartella Assets.

  3. Torna alla console Firebase e fai clic su Avanti nel flusso di lavoro di configurazione.

Passaggio 4: aggiungi gli SDK Firebase Unity

  1. Nella console Firebase, fai clic su Scarica SDK Firebase Unity, quindi decomprimi l'SDK in una posizione comoda.

    • Puoi scaricare di nuovo l'SDK Firebase Unity in qualsiasi momento.

    • L'SDK Firebase Unity non è specifico della piattaforma.

  2. Nel tuo progetto Unity aperto, vai a Asset > Importa pacchetto > Pacchetto personalizzato.

  3. Dall'SDK non compresso, seleziona l'elemento Firebase supportato prodotti che vuoi utilizzare la tua app.

    Analytics attivato

    • Aggiungi il pacchetto Firebase per Google Analytics: FirebaseAnalytics.unitypackage
    • Aggiungi i pacchetti per tutti gli altri prodotti Firebase che vuoi utilizzare in la tua app. Ad esempio, per utilizzare Firebase Authentication e Firebase Realtime Database:
      FirebaseAuth.unitypackage e FirebaseDatabase.unitypackage

    Analytics non attivato

    Aggiungi i pacchetti per i prodotti Firebase che vuoi utilizzare nella tua app. Ad esempio, per utilizzare Firebase Authentication e Firebase Realtime Database:
    FirebaseAuth.unitypackage e FirebaseDatabase.unitypackage

  4. Nella finestra Importa il pacchetto Unity, fai clic su Importa.

  5. Torna alla console Firebase e fai clic su Avanti nel flusso di lavoro di configurazione.

Passaggio 5: verifica i requisiti della versione di Google Play Services

L'SDK Firebase Unity per Android richiede Google Play services, che deve aggiornate prima di poter utilizzare l'SDK.

Aggiungi la seguente dichiarazione using e il codice di inizializzazione all'inizio della applicazione. Puoi controllare la presenza di Google Play services e, se vuoi, aggiornarli al richiesta dall'SDK Firebase Unity prima di chiamare qualsiasi altra disponibili nell'SDK.

using Firebase.Extensions;

Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWithOnMainThread(task => {
  var dependencyStatus = task.Result;
  if (dependencyStatus == Firebase.DependencyStatus.Available) {
    // Create and hold a reference to your FirebaseApp,
    // where app is a Firebase.FirebaseApp property of your application class.
       app = Firebase.FirebaseApp.DefaultInstance;

    // Set a flag here to indicate whether Firebase is ready to use by your app.
  } else {
    UnityEngine.Debug.LogError(System.String.Format(
      "Could not resolve all Firebase dependencies: {0}", dependencyStatus));
    // Firebase Unity SDK is not safe to use here.
  }
});

Ecco fatto. Il tuo progetto Unity è registrato e configurato per l'utilizzo di Firebase.

Tuttavia, se hai difficoltà a eseguire la configurazione, consulta le Domande frequenti e la risoluzione dei problemi di Unity.

Configurare un flusso di lavoro desktop (beta)

Quando crei un gioco, spesso è molto più facile testarlo prima nell'editor Unity e sulle piattaforme desktop, per poi eseguirlo e testarlo sui dispositivi mobili in un secondo momento durante lo sviluppo. Per supportare questo flusso di lavoro, forniamo una sottoinsieme degli SDK Firebase Unity che possono eseguire su Windows, macOS, Linux e dall'editor Unity.

  1. Configura un progetto Unity per la piattaforma desktop seguendo le stesse istruzioni per una piattaforma mobile (inizia con il passaggio Registra la tua app con Firebase sopra).

  2. Esegui il tuo progetto Unity nell'IDE Unity o selezionalo per creare il tuo progetto Unity progetto per computer.

  3. (Facoltativo) Esegui il progetto Unity in modalità di modifica.

    L'SDK Firebase Unity può essere eseguito anche nella modalità di modifica di Unity, il che consente di utilizzarlo nei plug-in dell'editor.

    1. Quando crei un FirebaseApp utilizzato dall'editor, non utilizzare l'istanza predefinita.

    2. Fornisci invece un nome univoco alla chiamata FirebaseApp.Create().

      Questo è importante per evitare un conflitto di opzioni tra l'istanza utilizzata dall'IDE Unity e dall'istanza utilizzata dal tuo progetto Unity.

Prodotti Firebase supportati

Scopri di più sulle librerie Firebase di Unity nella documentazione di riferimento.

Librerie Firebase disponibili per dispositivi mobili

L'SDK Firebase Unity supporta i seguenti prodotti Firebase su Apple e Android:

Prodotto Firebase Pacchetto Unity
AdMob Distribuito separatamente nel plug-in Unity AdMob
Analytics FirebaseAnalytics.unitypackage
App Check FirebaseAppCheck.unitypackage
Authentication FirebaseAuth.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Cloud Functions FirebaseFunctions.unitypackage
Cloud Messaging FirebaseMessaging.unitypackage
(consigliato) FirebaseAnalytics.unitypackage
Cloud Storage FirebaseStorage.unitypackage
Crashlytics FirebaseCrashlytics.unitypackage
(consigliato) FirebaseAnalytics.unitypackage
Dynamic Links FirebaseDynamicLinks.unitypackage
(consigliato) FirebaseAnalytics.unitypackage
Realtime Database FirebaseDatabase.unitypackage
Remote Config FirebaseRemoteConfig.unitypackage
(opzione consigliata) FirebaseAnalytics.unitypackage

Librerie Firebase disponibili per desktop

L'SDK Firebase Unity include il supporto dei flussi di lavoro desktop per un sottoinsieme di prodotti, consentendo l'utilizzo di determinate parti di Firebase Editor Unity e in versioni desktop autonome su Windows, macOS e Linux.

Prodotto Firebase (computer) Pacchetto Unity
App Check FirebaseAppCheck.unitypackage
Authentication FirebaseAuth.unitypackage
Cloud Functions FirebaseFunctions.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Cloud Storage FirebaseStorage.unitypackage
Realtime Database FirebaseDatabase.unitypackage
Remote Config FirebaseRemoteConfig.unitypackage

Per comodità, Firebase fornisce le restanti librerie desktop come implementazioni stub (non funzionali) quando esegui la compilazione per Windows, macOS e Linux. Pertanto, non è necessario compilare il codice in modo condizionale per scegliere come target il desktop.

Passaggi successivi