Powern Sie Ihre Unity- Spiele mit unseren Firebase Unity SDKs aus.
Um zu zeigen, wie einfach es ist, Firebase in Ihr Unity-Projekt einzubinden, haben wir ein Beispielspiel, MechaHamster, erstellt, das Sie von GitHub , dem App Store und dem Google Play Store herunterladen können.
Weitere Informationen zum Optimieren Ihrer Spiele mit Firebase finden Sie auf unserer Firebase-Spieleseite .
Firebase bereits zu Ihrem Unity-Projekt hinzugefügt? Stellen Sie sicher, dass Sie die neueste Version des Firebase Unity SDK verwenden.
Voraussetzungen
Installieren Sie Unity 2019.1 oder höher. Frühere Versionen können ebenfalls kompatibel sein, werden aber nicht aktiv unterstützt. Die Unterstützung für Unity 2019.1 gilt als veraltet und wird nach der nächsten Hauptversion nicht mehr aktiv unterstützt.
(Nur Apple-Plattformen) Installieren Sie Folgendes:
- Xcode 13.3.1 oder höher
- CocoaPods 1.10.0 oder höher
Stellen Sie sicher, dass Ihr Unity-Projekt diese Anforderungen erfüllt:
- Für iOS – zielt auf iOS 11 oder höher ab
- Für tvOS - zielt auf tvOS 12 oder höher ab
- Für Android – zielt auf API-Level 19 (KitKat) oder höher ab
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 Cloud Messaging auf iOS oder tvOS sind dies die Voraussetzungen:
- Richten Sie ein physisches Gerät ein.
- Fordern Sie einen Authentifizierungsschlüssel für Apple-Push-Benachrichtigungen für Ihr Apple-Entwicklerkonto an.
- Aktivieren Sie Push-Benachrichtigungen in XCode unter App > Capabilities .
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 Quickstart-Beispiele herunterladen.
Schritt 1 : Erstellen Sie ein Firebase-Projekt
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. Besuchen Sie Firebase-Projekte verstehen , um mehr über Firebase-Projekte zu erfahren.
Schritt 2 : Registrieren Sie Ihre App bei Firebase
Sie können eine oder mehrere Apps oder Spiele registrieren, um eine Verbindung mit Ihrem Firebase-Projekt herzustellen.
Gehen Sie zur Firebase-Konsole .
Klicken Sie in der Mitte der Projektübersichtsseite auf das Unity- Symbol (
), um den Setup-Workflow zu starten.Wenn Sie Ihrem Firebase-Projekt bereits eine App hinzugefügt haben, klicken Sie auf App hinzufügen , um die Plattformoptionen anzuzeigen.
Wählen Sie aus, welches Build-Ziel Ihres Unity-Projekts Sie registrieren möchten, oder Sie können jetzt sogar beide Ziele gleichzeitig registrieren.
Geben Sie die plattformspezifischen IDs Ihres Unity-Projekts ein.
Für iOS – Geben Sie die iOS-ID Ihres Unity-Projekts in das Feld iOS-Bundle-ID ein.
Für Android – Geben Sie die Android-ID Ihres Unity-Projekts in das Feld Android-Paketname ein.
Die Begriffe Paketname und Anwendungs-ID werden häufig synonym verwendet.
Öffnen Sie Ihr Unity-Projekt in Ihrer Unity-IDE und navigieren Sie dann zum Einstellungsbereich für jede Plattform:
Für iOS – Navigieren Sie zu Build-Einstellungen > iOS .
Für Android — Navigieren Sie zu Android > Player-Einstellungen > Andere Einstellungen .
Die ID Ihres Unity-Projekts ist der Bundle-ID- Wert (Beispiel-ID:
com.yourcompany.yourproject
).(Optional) Geben Sie den/die plattformspezifischen Spitznamen Ihres Unity-Projekts ein.
Diese Spitznamen sind interne, praktische Kennungen und nur für Sie in der Firebase-Konsole sichtbar.Klicken Sie auf App registrieren .
Schritt 3 : Fügen Sie Firebase-Konfigurationsdateien hinzu
Rufen Sie Ihre plattformspezifischen Firebase-Konfigurationsdateien im Setup-Workflow der Firebase-Konsole ab.
Für iOS — Klicken Sie auf Download GoogleService-Info.plist .
Für Android — Klicken Sie auf Download google-services.json .
Die Firebase-Konfigurationsdatei enthält eindeutige, aber nicht geheime Kennungen für Ihr Projekt. Weitere Informationen zu dieser Konfigurationsdatei finden Sie unter Firebase-Projekte verstehen .
Sie können Ihre Firebase-Konfigurationsdatei jederzeit erneut herunterladen.
Stellen Sie sicher, dass dem Namen der Konfigurationsdatei keine zusätzlichen Zeichen wie
(2)
angehängt werden.
Öffnen Sie das Projektfenster Ihres Unity-Projekts und verschieben Sie dann Ihre Konfigurationsdatei(en) in den Ordner
Assets
.Klicken Sie zurück in der Firebase-Konsole im Setup-Workflow auf Weiter .
Schritt 4 : Fügen Sie Firebase Unity SDKs hinzu
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 erneut herunterladen.
Das Firebase Unity SDK ist nicht plattformspezifisch.
Navigieren Sie in Ihrem geöffneten Unity-Projekt zu Assets > Import Package > Custom Package .
Wählen Sie aus dem 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 andere Firebase-Produkte hinzu, die Sie in Ihrer App verwenden möchten. So verwenden Sie beispielsweise die Firebase-Authentifizierung und die Firebase-Echtzeitdatenbank:
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. So verwenden Sie beispielsweise die Firebase-Authentifizierung und die Firebase-Echtzeitdatenbank:
FirebaseAuth.unitypackage
undFirebaseDatabase.unitypackage
- Fügen Sie das Firebase-Paket für Google Analytics hinzu:
Klicken Sie im Fenster Unity-Paket importieren auf Importieren .
Klicken Sie zurück in der Firebase-Konsole im Setup-Workflow auf Weiter .
Schritt 5 : Bestätigen Sie die Versionsanforderungen für die Google Play-Dienste
Das Firebase Unity SDK für Android erfordert Google Play-Dienste , die auf dem neuesten Stand sein müssen, bevor das SDK verwendet werden kann.
Fügen Sie am Anfang Ihrer Anwendung den folgenden Code hinzu. Sie können nach Google Play-Diensten suchen und diese optional auf die für das Firebase Unity SDK erforderliche Version aktualisieren, bevor Sie andere Methoden im SDK aufrufen.
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. } });
Sie sind bereit! Ihr Unity-Projekt ist registriert und für die Verwendung von Firebase konfiguriert.
Wenn Sie jedoch Probleme bei der Einrichtung haben, besuchen Sie Unity Troubleshooting & FAQ .
Einrichten eines Desktop-Workflows ( Beta )
Wenn Sie ein Spiel erstellen, ist es oft viel einfacher, Ihr Spiel zuerst im Unity-Editor und auf Desktop-Plattformen zu testen und es später in der Entwicklung auf Mobilgeräten bereitzustellen und zu testen. Zur Unterstützung dieses Workflows stellen wir eine Teilmenge 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 eine Desktop-Plattform ein, indem Sie die gleichen Anweisungen wie für eine mobile Plattform befolgen (beginnen Sie mit dem obigen Schritt App bei Firebase registrieren ).
Führen Sie Ihr Unity-Projekt in der Unity-IDE aus oder wählen Sie die Erstellung Ihres Unity-Projekts für den Desktop aus.
(Optional) Führen Sie Ihr Unity-Projekt im Bearbeitungsmodus aus.
Das Firebase Unity SDK kann auch im Bearbeitungsmodus von Unity ausgeführt werden, sodass es in Editor-Plugins verwendet werden kann.
Verwenden Sie beim Erstellen einer vom Editor verwendeten
FirebaseApp
nicht die Standardinstanz.Geben Sie stattdessen einen eindeutigen Namen für den
FirebaseApp.Create()
-Aufruf an.Dies ist wichtig, um einen Optionskonflikt zwischen der von der Unity-IDE verwendeten Instanz und der von Ihrem Unity-Projekt verwendeten Instanz 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 | Separat im AdMob Unity-Plug-in verteilt |
Analytik | FirebaseAnalytics.unitypackage |
App-Check | FirebaseAppCheck.unitypackage |
Authentifizierung | FirebaseAuth.unitypackage |
Cloud-Firestore | FirebaseFirestore.unitypackage |
Cloud-Funktionen | FirebaseFunctions.unitypackage |
Cloud-Messaging | FirebaseMessaging.unitypackage (empfohlen) FirebaseAnalytics.unitypackage |
Cloud-Speicher | FirebaseStorage.unitypackage |
Crashlytics | FirebaseCrashlytics.unitypackage (empfohlen) FirebaseAnalytics.unitypackage |
Dynamische Links | FirebaseDynamicLinks.unitypackage (empfohlen) FirebaseAnalytics.unitypackage |
Echtzeit-Datenbank | FirebaseDatabase.unitypackage |
Remote-Konfig | FirebaseRemoteConfig.unitypackage (empfohlen) FirebaseAnalytics.unitypackage |
Verfügbare Firebase-Bibliotheken für Desktop
Das Firebase Unity SDK umfasst Desktop-Workflow-Unterstützung für eine Untergruppe von Produkten, sodass bestimmte Teile von Firebase im Unity-Editor und in eigenständigen Desktop-Builds unter Windows, macOS und Linux verwendet werden können.
Firebase-Produkt (Desktop) | Unity-Paket |
---|---|
App-Check | FirebaseAppCheck.unitypackage |
Authentifizierung | FirebaseAuth.unitypackage |
Cloud-Funktionen | FirebaseFunctions.unitypackage |
Cloud-Firestore | FirebaseFirestore.unitypackage |
Cloud-Speicher | FirebaseStorage.unitypackage |
Echtzeit-Datenbank | FirebaseDatabase.unitypackage |
Remote-Konfig | FirebaseRemoteConfig.unitypackage |
Firebase stellt die verbleibenden Desktop-Bibliotheken als (nicht funktionale) Stub-Implementierungen bereit, um die Erstellung für Windows, macOS und Linux zu erleichtern. Daher müssen Sie Code nicht bedingt kompilieren, um auf den Desktop abzuzielen.
Nächste Schritte
Entdecken Sie Beispiel-Firebase-Apps .
Bereiten Sie den Start Ihrer App vor:
- Richten Sie Budgetbenachrichtigungen für Ihr Projekt in der Google Cloud Console ein.
- Überwachen Sie das Nutzungs- und Abrechnungs- Dashboard in der Firebase-Konsole, um sich einen Überblick über die Nutzung Ihres Projekts über mehrere Firebase-Dienste hinweg zu verschaffen.
- Überprüfen Sie die Firebase-Startcheckliste .
Haben Sie Probleme mit Firebase und Ihrem Unity-Projekt? Besuchen Sie Unity Troubleshooting & FAQ .