Mit unseren Firebase Unity SDKs können Sie Ihre Unity-Spiele optimieren.
Um zu zeigen, wie einfach die Einbindung von Firebase in Ihr Unity-Projekt ist, haben wir das Beispielspiel „MechaHamster“ erstellt. Wenn Sie ausprobieren möchten, wie Sie einem Spiel Firebase hinzufügen, verwenden Sie die Starterversion auf GitHub. Wenn du eine fertige Version möchtest, sieh dir die Versionen im App Store oder in der Google Play Store an.
Weitere Informationen dazu, wie Sie Ihre Spiele mit Firebase optimieren können, finden Sie auf der Firebase-Seite für Spiele.
Haben Sie Firebase bereits Ihrem Unity-Projekt hinzugefügt? Sie benötigen die neueste Version des Firebase Unity SDK.
Vorbereitung
Installieren Sie Unity 2021 LTS oder höher. Der Support für Unity 2020 wird eingestellt und nach der nächsten Hauptversion nicht mehr aktiv unterstützt. Ältere Versionen sind möglicherweise auch kompatibel, werden aber nicht aktiv unterstützt.
(Nur Apple-Plattformen) Installieren Sie Folgendes:
- Xcode 13.3.1 oder höher
- CocoaPods 1.12.0 oder höher
Ihr Unity-Projekt muss die folgenden Anforderungen erfüllen:
- iOS: Ausrichtung auf iOS 13 oder höher
- Für tvOS: Ausrichtung auf tvOS 13 oder höher
- Für Android: Ausrichtung auf API-Level 21 (Lollipop) oder höher
Richten Sie ein physisches Gerät ein oder verwenden Sie einen Emulator, um Ihre App auszuführen.
Für Apple-Plattformen: Richten Sie ein physisches Gerät ein oder verwenden Sie einen iOS- oder tvOS-Simulator.
Für Android – Emulatoren müssen ein Emulator-Image mit Google Play verwenden.
Wenn Sie noch kein Unity-Projekt haben und nur ein Firebase-Produkt ausprobieren möchten, können Sie eines unserer Beispiele für den Schnellstart herunterladen.
Schritt 1: Firebase-Projekt erstellen
Bevor Sie Firebase zu Ihrem Unity-Projekt hinzufügen können, müssen Sie ein Firebase-Projekt erstellen, um eine Verbindung zu Ihrem Unity-Projekt herzustellen. Weitere Informationen zu Firebase-Projekten finden Sie unter Firebase-Projekte verstehen.
Schritt 2: App bei Firebase registrieren
Sie können eine oder mehrere Apps oder Spiele registrieren, um eine Verbindung zu Ihrem Firebase-Projekt herzustellen.
Rufen Sie die Firebase Console auf.
Klicken Sie in der Mitte der Projektübersicht auf das Symbol Unity (
), um den Einrichtungsworkflow zu starten.Wenn Sie Ihrem Firebase-Projekt bereits eine App hinzugefügt haben, klicken Sie auf App hinzufügen, um die Plattformoptionen aufzurufen.
Wählen Sie das Build-Ziel Ihres Unity-Projekts aus, das Sie registrieren möchten. Sie können auch beide Ziele gleichzeitig registrieren.
Geben Sie die plattformspezifischen IDs Ihres Unity-Projekts ein.
iOS: Geben Sie die iOS-ID Ihres Unity-Projekts in das Feld iOS-Bundle-ID ein.
Android: Geben Sie die Android-ID Ihres Unity-Projekts in das Feld Android-Paketname ein.
Die Begriffe Paketname und Anwendungs-ID werden oft synonym verwendet.
Optional: Geben Sie die plattformspezifischen Aliasse Ihres Unity-Projekts ein.
Diese Alias sind interne Kennungen und sind nur für Sie in der Firebase-Konsole sichtbar.Klicken Sie auf App registrieren.
Schritt 3: Firebase-Konfigurationsdateien hinzufügen
Rufen Sie die platformspezifischen Firebase-Konfigurationsdateien im Firebase Workflow zur Einrichtung der Konsole ab.
iOS: Klicken Sie auf GoogleService-Info.plist herunterladen.
Android: Klicken Sie auf google-services.json herunterladen.
Öffnen Sie das Fenster Project (Projekt) Ihres Unity-Projekts und verschieben Sie die Konfigurationsdatei(en) in den Ordner
Assets
.Klicken Sie in der Firebase-Konsole im Einrichtungsworkflow auf Weiter.
Schritt 4: Firebase Unity SDKs hinzufügen
Klicken Sie in der Firebase-Konsole auf Firebase Unity SDK herunterladen und entpacken Sie das SDK an einem geeigneten Ort.
Sie können das Firebase Unity SDK jederzeit noch einmal herunterladen.
Das Firebase Unity SDK ist nicht plattformspezifisch.
Rufen Sie in Ihrem geöffneten Unity-Projekt Assets > Import Package > Custom Package auf.
Wählen Sie im entpackten SDK die unterstützten Firebase-Produkte aus, die Sie in Ihrer App verwenden möchten.
Analytics aktiviert
- Fügen Sie das Firebase-Paket für Google Analytics hinzu:
FirebaseAnalytics.unitypackage
- Fügen Sie die Pakete für alle anderen Firebase-Produkte hinzu, die Sie in Ihrer App verwenden möchten. So verwenden Sie beispielsweise Firebase Authentication und Firebase Realtime Database:
FirebaseAuth.unitypackage
undFirebaseDatabase.unitypackage
Analytics nicht aktiviert
Fügen Sie die Pakete für die Firebase-Produkte hinzu, die Sie in Ihrer App verwenden möchten. Wenn Sie beispielsweise Firebase Authentication und Firebase Realtime Database verwenden möchten, fügen Sie Folgendes hinzu:
FirebaseAuth.unitypackage
undFirebaseDatabase.unitypackage
- Fügen Sie das Firebase-Paket für Google Analytics hinzu:
Klicken Sie im Fenster "Import Unity Package" (Unity-Paket importieren) auf "Import" (Importieren).
Klicken Sie in der Firebase-Konsole im Einrichtungsworkflow auf Weiter.
Schritt 5: Anforderungen an die Version der Google Play-Dienste bestätigen
Für das Firebase Unity SDK for Android ist Google Play services erforderlich. Dieses muss auf dem neuesten Stand sein, damit das SDK verwendet werden kann.
Fügen Sie die folgende using
-Anweisung und den Initialisierungscode am Anfang Ihrer Anwendung ein. Sie können prüfen, ob Google Play services auf die Version aktualisiert werden muss, die vom Firebase Unity SDK benötigt wird, und sie gegebenenfalls aktualisieren, bevor Sie andere Methoden im SDK aufrufen.
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.
}
});
Fertig! Ihr Unity-Projekt ist registriert und für die Verwendung von Firebase konfiguriert.
Wenn Sie jedoch Probleme bei der Einrichtung haben, lesen Sie den Hilfeartikel Fehlerbehebung und FAQs zu Unity.
Desktop-Workflow einrichten (Beta)
Wenn Sie ein Spiel erstellen, ist es oft viel einfacher, es zuerst im Unity-Editor und auf Desktop-Plattformen zu testen und dann später in der Entwicklung auf Mobilgeräten bereitzustellen und zu testen. Zur Unterstützung dieses Workflows stellen wir einen Teil der Firebase Unity SDKs bereit, die unter Windows, macOS, Linux und im Unity-Editor ausgeführt werden können.
Richten Sie ein Unity-Projekt für die Desktopplattform ein. Folgen Sie dazu der Anleitung für eine mobile Plattform (beginnen Sie mit dem Schritt App bei Firebase registrieren oben).
Führen Sie Ihr Unity-Projekt in der Unity-IDE aus oder wählen Sie aus, dass Ihr Unity-Projekt für Computer erstellt werden soll.
Optional: Führen Sie Ihr Unity-Projekt im Bearbeitungsmodus aus.
Das Firebase Unity SDK kann auch im Bearbeitungsmodus von Unity ausgeführt werden, sodass er in Editor-Plug-ins verwendet werden kann.
Wenn Sie eine
FirebaseApp
erstellen, die vom Editor verwendet wird, verwenden Sie nicht die Standardinstanz.Geben Sie stattdessen einen eindeutigen Namen für den
FirebaseApp.Create()
-Aufruf an.Dies ist wichtig, um einen Konflikt bei Optionen zwischen der Instanz, die von der Unity-IDE verwendet wird, und der Instanz Ihres Unity-Projekts zu vermeiden.
Unterstützte Firebase-Produkte
Weitere Informationen zu den Unity-Firebase-Bibliotheken finden Sie in der Referenzdokumentation.
Verfügbare Firebase-Bibliotheken für Mobilgeräte
Das Firebase Unity SDK unterstützt die folgenden Firebase-Produkte auf Apple und Android:
Firebase-Produkt | Unity-Paket |
---|---|
AdMob | Wird separat im AdMob-Unity-Plug-in verteilt |
Analytics | FirebaseAnalytics.unitypackage |
App Check | FirebaseAppCheck.unitypackage |
Authentication | FirebaseAuth.unitypackage |
Cloud Firestore | FirebaseFirestore.unitypackage |
Cloud Functions | FirebaseFunctions.unitypackage |
Cloud Messaging | FirebaseMessaging.unitypackage (empfohlen) FirebaseAnalytics.unitypackage |
Cloud Storage | FirebaseStorage.unitypackage |
Crashlytics | FirebaseCrashlytics.unitypackage (empfohlen) FirebaseAnalytics.unitypackage |
Dynamic Links | FirebaseDynamicLinks.unitypackage (empfohlen) FirebaseAnalytics.unitypackage |
Realtime Database | FirebaseDatabase.unitypackage |
Remote Config | FirebaseRemoteConfig.unitypackage (empfohlen) FirebaseAnalytics.unitypackage |
Verfügbare Firebase-Bibliotheken für Computer
Das Firebase Unity SDK bietet Unterstützung für Desktop-Workflows für eine Reihe von Produkten. So können bestimmte Teile von Firebase im Unity-Editor und in eigenständigen Desktop-Builds unter Windows, macOS und Linux verwendet werden.
Firebase-Produkt (Computer) | Unity-Paket |
---|---|
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 stellt die übrigen Desktopbibliotheken als Stub-Implementierungen (nicht funktionsfähig) bereit, um die Entwicklung für Windows, macOS und Linux zu vereinfachen. Daher müssen Sie für das Targeting auf den Desktop keinen bedingten Code kompilieren.
Nächste Schritte
Firebase-Beispiel-Apps ansehen
Einführung Ihrer App vorbereiten:
- Richten Sie in der Google Cloud Console Budgetbenachrichtigungen für Ihr Projekt ein.
- Über das Dashboard „Nutzung und Abrechnung“ in der Firebase-Konsole erhalten Sie einen Überblick über die Nutzung Ihres Projekts in mehreren Firebase-Diensten.
- Sehen Sie sich die Checkliste für die Einführung von Firebase an.
Haben Sie Probleme mit Firebase und Ihrem Unity-Projekt? Weitere Informationen finden Sie unter Fehlerbehebung und FAQs für Unity.