Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

Aggiungi Firebase al tuo progetto Unity

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

Per mostrare quanto sia facile collegare Firebase al tuo progetto Unity, abbiamo creato un gioco di esempio, MechaHamster, che puoi scaricare da GitHub , App Store e Google Play Store .

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (Play Store)


Scopri ulteriori informazioni su come potenziare i tuoi giochi con Firebase nella nostra pagina dei giochi Firebase .

Hai già aggiunto Firebase al tuo progetto Unity? Assicurati di utilizzare la versione più recente di Firebase Unity SDK .

Prerequisiti

  • Installa Unity 2017.4 o successivo. Anche le versioni precedenti potrebbero essere compatibili, ma non saranno supportate attivamente.

  • (Solo iOS) Installa quanto segue:

    • Xcode 9.4.1 o successivo
    • CocoaPods 1.10.0 o successivo
  • Assicurati che il tuo progetto Unity soddisfi questi requisiti:

    • Per iOS : target iOS 10 o versioni successive
    • Per Android : ha come target il livello API 16 (Jelly Bean) o successivo
  • Configura un dispositivo fisico o usa un emulatore per eseguire la tua app.

    • Per iOS : configura un dispositivo iOS fisico o utilizza il simulatore iOS.

    • Per Android : gli emulatori devono utilizzare un'immagine dell'emulatore con Google Play.

Se non disponi già di un progetto Unity e desideri semplicemente provare un prodotto Firebase, puoi scaricare uno dei nostri esempi di avvio rapido .

Passaggio 1 : crea un progetto Firebase

Prima di poter aggiungere Firebase al tuo progetto Unity, devi creare un progetto Firebase per connetterti al tuo progetto Unity. Visita Comprensione dei progetti Firebase per ulteriori informazioni sui progetti Firebase.

Passaggio 2 : registra la tua app con Firebase

Puoi registrare una o più app o giochi per connetterti al tuo progetto Firebase.

  1. Vai alla console Firebase .

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

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

  3. Seleziona quale target di build del tuo progetto Unity desideri registrare, oppure puoi anche scegliere di registrare entrambi i target contemporaneamente.

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

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

    • Per Android : inserisci l'ID Android del tuo progetto Unity nel campo del nome del pacchetto Android .
      I termini nome pacchetto e ID applicazione sono spesso usati in modo intercambiabile.

  5. (Facoltativo) Inserisci i nickname specifici della piattaforma del tuo progetto Unity.
    Questi soprannomi sono identificatori interni di convenienza e sono visibili solo a te nella console Firebase.

  6. Fare clic su Registra app .

Passaggio 3 : aggiungi i file di configurazione di Firebase

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

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

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

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

  3. Torna nella console Firebase, nel flusso di lavoro di configurazione, fai clic su Avanti .

Passaggio 4 : aggiungi gli SDK di Firebase Unity

  1. Nella console Firebase, fai clic su Scarica Firebase Unity SDK , quindi decomprimi l'SDK in un punto comodo.

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

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

  2. Nel tuo progetto Unity aperto, vai a Assets > Import Package > Custom Package .

  3. Dall'SDK decompresso, seleziona i prodotti Firebase supportati che desideri utilizzare nella tua app.

    Analitica abilitata

    • Aggiungi il pacchetto Firebase per Google Analytics: FirebaseAnalytics.unitypackage
    • Aggiungi i pacchetti per qualsiasi altro prodotto Firebase che desideri utilizzare nella tua app. Ad esempio, per utilizzare Firebase Authentication e Firebase Realtime Database:
      FirebaseAuth.unitypackage e FirebaseDatabase.unitypackage

    Analitica non abilitata

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

  4. Nella finestra Importa pacchetto Unity , fare clic su Importa .

  5. Torna nella console Firebase, nel flusso di lavoro di configurazione, fai clic su Avanti .

Passaggio 5 : conferma i requisiti della versione dei servizi di Google Play

L'SDK Firebase Unity per Android richiede i servizi Google Play , che devono essere aggiornati prima di poter utilizzare l'SDK.

Aggiungi il seguente codice all'inizio della tua applicazione. Puoi verificare e, facoltativamente, aggiornare i servizi di Google Play alla versione richiesta dall'SDK di Firebase Unity prima di chiamare qualsiasi altro metodo nell'SDK.

Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWith(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.
  }
});

Sei pronto! Il tuo progetto Unity è registrato e configurato per utilizzare Firebase.

Tuttavia, se hai problemi con la configurazione, visita la risoluzione dei problemi e le domande frequenti di Unity .

Configurare un flusso di lavoro desktop ( beta )

Quando crei un gioco, spesso è molto più semplice testarlo prima nell'editor di Unity e su piattaforme desktop, quindi distribuirlo e testarlo su dispositivi mobili in seguito durante lo sviluppo. Per supportare questo flusso di lavoro, forniamo un sottoinsieme degli SDK di Firebase Unity che possono essere eseguiti su Windows, macOS, Linux e dall'editor di Unity.

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

  2. Esegui il tuo progetto Unity nell'IDE Unity o seleziona per creare il tuo progetto Unity per desktop .

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

    L'SDK di Firebase Unity può essere eseguito anche nella modalità di modifica di Unity, consentendone l'utilizzo nei plug-in dell'editor.

    1. Quando crei una FirebaseApp utilizzata dall'editor, non utilizzare l'istanza predefinita.

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

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

Prodotti Firebase supportati

Ulteriori informazioni sulle librerie Unity Firebase nella documentazione di riferimento .

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

Prodotto Firebase Pacchetto Unity
AdMob Distribuito separatamente nel plug-in Unity di AdMob
Analisi FirebaseAnalytics.unitypackage
Autenticazione FirebaseAuth.unitypackage
Cloud Firestore (beta) FirebaseFirestore.unitypackage
Funzioni cloud FirebaseFunctions.unitypackage
Messaggistica cloud FirebaseMessaging.unitypackage
(consigliato) FirebaseAnalytics.unitypackage
Archiviazione cloud FirebaseStorage.unitypackage
Crashlytics FirebaseCrashlytics.unitypackage
(consigliato) FirebaseAnalytics.unitypackage
Collegamenti dinamici FirebaseDynamicLinks.unitypackage
(consigliato) FirebaseAnalytics.unitypackage
Database in tempo reale FirebaseDatabase.unitypackage
Configurazione remota FirebaseRemoteConfig.unitypackage
(consigliato) FirebaseAnalytics.unitypackage

Prodotti Firebase supportati (desktop)

L'SDK di Firebase Unity include il supporto del flusso di lavoro desktop per un sottoinsieme di prodotti, consentendo di utilizzare alcune parti di Firebase nell'editor Unity e in build desktop indipendenti su Windows, macOS e Linux.

Prodotto Firebase (desktop) Pacchetto Unity
Autenticazione FirebaseAuth.unitypackage
Funzioni cloud FirebaseFunctions.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Archiviazione cloud FirebaseStorage.unitypackage
Database in tempo reale FirebaseDatabase.unitypackage
Configurazione remota FirebaseRemoteConfig.unitypackage

Firebase fornisce le librerie desktop rimanenti come implementazioni stub (non funzionali) per comodità durante la creazione per Windows, macOS e Linux. Pertanto, non è necessario compilare il codice in modo condizionale per indirizzare il desktop.

Prossimi passi