Potenzia i tuoi giochi Unity con i nostri SDK Firebase Unity.
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.
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 di Unity 2020 è considerato ritirato e non sarà più supportato attivamente dopo la prossima release principale. Anche le versioni precedenti potrebbero essere compatibili, ma non lo saranno attivamente supportati.
(Solo piattaforme Apple) Installa quanto segue:
- Xcode 13.3.1 o versioni successive
- CocoaPods 1.12.0 o versioni successive
Assicurati che il tuo progetto Unity soddisfi i seguenti requisiti:
- Per iOS: ha come 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'immagine dell'emulatore con Google Play.
- Accedi a Firebase con il tuo Account Google.
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 progetto Firebase da collegare al progetto Unity. Consulta Informazioni sui progetti Firebase per saperne di più su questi progetti.
Passaggio 2: registra la tua app in Firebase
Puoi registrare uno o più giochi o app da collegare a Firebase progetto.
Vai alla console Firebase.
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.
Seleziona la destinazione di build del tuo progetto Unity che vuoi registrare. oppure selezionare la registrazione di entrambi i target contemporaneamente.
Inserisci gli ID specifici della piattaforma del tuo progetto Unity.
Per iOS: inserisci l'ID iOS del progetto Unity nella casella Pacchetto iOS ID .
Per Android: inserisci l'ID Android del progetto Unity nel campo Nome del pacchetto Android.
Vengono spesso utilizzati i termini nome pacchetto e ID applicazione in modo intercambiabile.
(Facoltativo) Inserisci i nickname specifici della piattaforma per il progetto Unity.
Questi nickname sono identificatori interni di praticità e sono visibili solo nella console Firebase.Fai clic su Registra app.
Passaggio 3: aggiungi i file di configurazione di Firebase
Ottieni i file di configurazione Firebase specifici per la 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.
Apri la finestra Project del progetto Unity, quindi sposta la configurazione uno o più file nella cartella
Assets
.Torna nella console Firebase e, nel flusso di lavoro di configurazione, fai clic su Avanti.
Passaggio 4: aggiungi gli SDK Firebase Unity
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.
Nel progetto Unity aperto, vai a Asset > Importa pacchetto > Pacchetto personalizzato.
Dall'SDK non compresso, seleziona i prodotti Firebase supportati che vuoi utilizzare nella 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 nella tua app. Ad esempio, per utilizzare Firebase Authentication e Firebase Realtime Database:
FirebaseAuth.unitypackage
eFirebaseDatabase.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
eFirebaseDatabase.unitypackage
- Aggiungi il pacchetto Firebase per Google Analytics:
Nella finestra Importa il pacchetto Unity, fai clic su Importa.
Torna nella console Firebase e, nel flusso di lavoro di configurazione, fai clic su Avanti.
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 verificare e, facoltativamente, aggiornare Google Play services alla versione richiesta dall'SDK Firebase Unity prima di chiamare altri metodi 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 progetto Unity è registrato e configurato per l'utilizzo di Firebase.
Se hai problemi di configurazione, visita Risoluzione dei problemi e Domande frequenti.
Configurare un flusso di lavoro desktop (beta)
Quando crei un gioco, spesso è molto più facile testarlo nel Editor Unity e sulle piattaforme desktop, poi esegui il deployment e il test sui dispositivi mobili più avanti nello 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.
Per configurare un progetto Unity su una piattaforma desktop, segui le stesse istruzioni riportate per una piattaforma mobile (inizia con Registra l'app con Firebase (passaggio precedente).
Esegui il tuo progetto Unity nell'IDE Unity o selezionalo per creare il tuo progetto Unity progetto per computer.
(Facoltativo) Esegui il progetto Unity in modalità di modifica.
L'SDK Firebase Unity può essere eseguito anche in modalità di modifica di Unity, consentendone l'utilizzo nei plug-in dell'editor.
Quando crei un elemento
FirebaseApp
utilizzato dall'editor, non usare predefinita.Devi, invece, fornire un nome univoco alla chiamata
FirebaseApp.Create()
.Questo è importante per evitare un conflitto di opzioni tra l'istanza utilizzata dall'IDE Unity e l'istanza utilizzata dal progetto Unity.
Prodotti Firebase supportati
Scopri di più sulle librerie Unity Firebase nel 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 AdMob plug-in Unity |
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 (consigliato) FirebaseAnalytics.unitypackage |
Librerie Firebase disponibili per computer
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 |
Firebase fornisce le librerie desktop rimanenti come stub (non funzionante) per una maggiore praticità durante la creazione per Windows, macOS e Linux. Pertanto, non è necessario compilare il codice in modo condizionale per scegliere come target il desktop.
Passaggi successivi
Esplora le app Firebase di esempio.
Preparati a lanciare l'app:
- Configura gli avvisi sul budget per il tuo progetto nella console Google Cloud.
- Monitora la dashboard Utilizzo e fatturazione nella console Firebase per avere un quadro complessivo dell'utilizzo del progetto su più servizi Firebase.
- Esamina l'elenco di controllo per il lancio di Firebase.
Hai problemi con Firebase e il tuo progetto Unity? Visita la pagina Risoluzione dei problemi e Domande frequenti.