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

Aggiungi Firebase al tuo progetto Unity

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

Per mostrare come sia facile collegare Firebase nel vostro progetto Unity, abbiamo fatto un gioco di esempio, MechaHamster, che è possibile scaricare dal GitHub, l'App Store, e il Play Store di Google.

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (Play Store)


Per saperne di più informazioni su di accendere i tuoi giochi con Firebase alla nostra pagina di giochi Firebase .

Hai già aggiunto Firebase al tuo progetto Unity? Assicurarsi che si sta utilizzando la versione più recente del Firebase dell'Unità SDK .

Prerequisiti

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

  • (solo iOS) installare quanto segue:

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

    • Per iOS - si rivolge iOS 10 o superiore
    • Per Android - livello target di API 16 (Jelly Bean) o superiore

  • Configura un dispositivo fisico o usa un emulatore per eseguire la tua app.

    • Per iOS - Configurare un dispositivo iOS fisico o utilizzare il simulatore iOS.

    • Per Android - Emulatori deve usare un'immagine emulatore con Google Play.

Se non si dispone già di un progetto Unity e vogliono solo provare un prodotto Firebase, è possibile scaricare uno dei nostri esempi rapidi .

Passo 1: Creare un progetto Firebase

Prima di poter aggiungere Firebase al tuo progetto Unity, devi creare un progetto Firebase per connetterti al tuo progetto Unity. Visita Capire Firebase progetti per saperne di più su progetti Firebase.

Step 2: Registrare l'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 panoramica del progetto, fare clic sull'icona Unità ( ) per lanciare il flusso di lavoro di installazione.

    Se è già stato aggiunto un app per il vostro progetto Firebase, fare clic su Aggiungi app per visualizzare le opzioni di 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 - Inserire del progetto Unity iOS ID nel fascio ID iOS campo.

    • Per Android - Inserire del progetto Unity Android ID nel nome del pacchetto Android campo.
      Il nome del pacchetto termini e ID applicazione sono spesso usati come sinonimi.

  5. (Facoltativo) Immettere soprannome specifico per la piattaforma del progetto Unity (s).
    Questi soprannomi sono identificatori interni di convenienza e sono visibili solo a te nella console Firebase.

  6. Fare clic su Registra app.

Fase 3: Aggiungere i file di configurazione Firebase

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

    • Per iOS - Fare clic su Scarica GoogleService-Info.plist.

    • Per Android - Fare clic su Download google-services.json.

  2. Aprire la finestra del progetto del progetto Unity, quindi spostare il file di configurazione (s) nella Assets cartella.

  3. Torna nella console Firebase, nel flusso di lavoro di installazione, fare clic su Avanti.

Fase 4: Aggiungere Firebase Unity SDK

  1. Nella console Firebase, fare clic su Download Firebase Unità SDK, quindi decomprimere l'SDK posto comodo.

    • È possibile scaricare il Firebase Unity SDK di nuovo in qualsiasi momento.

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

  2. Nel progetto aperto Unità, navigare ad Attività> Importa pacchetto> pacchetto personalizzato.

  3. Dal SDK decompresso, selezionare i prodotti Firebase supportati che si desidera utilizzare nella vostra applicazione.

    Analitica abilitata

    • Aggiungere 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 Unità Package, fare clic su Importa.

  5. Torna nella console Firebase, nel flusso di lavoro di installazione, fare clic su Avanti.

Fase 5: Conferma di Google Play Services requisiti di versione

Il Firebase Unity SDK per Android richiede Google Play Services , che devono essere up-to-date prima che l'SDK può essere utilizzato.

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.

Se hai problemi a ottenere istituito, però, visitare la risoluzione dei problemi Unità & FAQ .

Impostare 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 della Firebase dell'Unità SDK , che può essere eseguito su Windows, MacOS, Linux, e da dentro l'editor Unity.

  1. Impostare un progetto Unity desktop piattaforma seguendo le stesse istruzioni per una piattaforma mobile (iniziare con il Registro tua app con Firebase passo sopra).

  2. Eseguire il progetto Unity nell'Unità IDE o scegliere di costruire il vostro progetto Unity per desktop.

  3. (Opzionale) Eseguire il progetto Unity in modalità Edit.

    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 si crea un FirebaseApp utilizzato dal redattore, non utilizzare l'istanza predefinita.

    2. Invece, fornire un nome univoco al FirebaseApp.Create() chiamata.

      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

Per ulteriori informazioni sulle librerie Unità Firebase nella documentazione di riferimento .

Il Firebase Unity SDK 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
Nuvola 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)

Il Firebase Unity SDK include il supporto del flusso di lavoro del desktop per un sottoinsieme di prodotti, permettendo alcune parti del Firebase da usare nell'editor Unità e in desktop stand-alone si basa 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