Firebase zu Ihrem Unity-Projekt hinzufügen

Mit unseren Firebase-Unity-SDKs können Sie Ihre Unity-Spiele noch besser machen.

Um zu zeigen, wie einfach es ist, Firebase in Ihr Unity-Projekt zu integrieren, haben wir das Beispielspiel MechaHamster erstellt. Wenn Sie Firebase in ein Spiel einbinden möchten, verwenden Sie die Starterversion auf GitHub. Wenn Sie eine vollständige Version wünschen, sehen Sie sich die Versionen im App Store oder im Google Play Store an.

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (Play Store)


Weitere Informationen dazu, wie Sie Ihre Spiele mit Firebase optimieren können, finden Sie auf unserer Firebase-Seite für Spiele.

Haben Sie Firebase bereits zu Ihrem Unity-Projekt hinzugefügt? Achten Sie darauf, dass Sie die neueste Version des Firebase Unity SDK verwenden.

Vorbereitung

  • Installieren Sie Unity 2021 LTS oder höher. Die Unterstützung für Unity 2020 gilt als eingestellt und wird 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:

    • Für iOS: Zielgruppe sind Geräte mit iOS 13 oder höher.
    • Für tvOS: Ziel ist 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 Cloud Messaging auf iOS- oder tvOS-Geräten gelten die folgenden Voraussetzungen:

      • Richten Sie ein physisches Gerät ein.
      • Rufen Sie einen APNs-Authentifizierungsschlüssel (Apple Push Notification Service) für Ihr Apple-Entwicklerkonto ab.
      • 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 Schnellstartbeispiele 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

  1. Klicken Sie in der Firebase-Konsole auf Projekt hinzufügen.

    • Wenn Sie einem vorhandenen Google Cloud-Projekt Firebase-Ressourcen hinzufügen möchten, geben Sie den Projektnamen ein oder wählen Sie das Projekt aus dem Drop-down-Menü aus.

    • Wenn Sie ein neues Projekt erstellen möchten, geben Sie einen Projektnamen ein. Optional können Sie auch die Projekt-ID bearbeiten, die unter dem Projektnamen angezeigt wird.

  2. Lesen Sie sich die Nutzungsbedingungen von Firebase durch und akzeptieren Sie sie.

  3. Klicken Sie auf Weiter.

  4. (Optional) Richten Sie Google Analytics für Ihr Projekt ein. So können Sie die folgenden Firebase-Produkte optimal nutzen: Firebase A/B Testing, Cloud Messaging, Crashlytics, In-App Messaging und Remote Config (einschließlich Personalisierung).

    Wählen Sie entweder ein vorhandenes Google Analytics-Konto aus oder erstellen Sie ein neues Konto. Wenn Sie ein neues Konto erstellen, wählen Sie den Analytics-Berichtsspeicherort aus und akzeptieren Sie dann die Datenfreigabeeinstellungen und die Google Analytics-Nutzungsbedingungen für Ihr Projekt.

  5. Klicken Sie auf Projekt erstellen (oder auf Firebase hinzufügen, wenn Sie Firebase einem vorhandenen Google Cloud-Projekt hinzufügen).

Firebase stellt automatisch Ressourcen für Ihr Firebase-Projekt bereit. Nach Abschluss des Vorgangs werden Sie zur Übersichtsseite für Ihr Firebase-Projekt in der Firebase Console weitergeleitet.

Schritt 2: App bei Firebase registrieren

Sie können eine oder mehrere Apps oder Spiele registrieren, um eine Verbindung zu Ihrem Firebase-Projekt herzustellen.

  1. Rufen Sie die Firebase-Konsole auf.

  2. 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.

  3. Wählen Sie das Build-Ziel Ihres Unity-Projekts aus, das Sie registrieren möchten. Sie können auch beide Ziele gleichzeitig registrieren.

  4. 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 oft synonym verwendet.

    Öffnen Sie Ihr Unity-Projekt in Ihrer Unity-IDE und rufen Sie dann die Einstellungen für die einzelnen Plattformen auf:

    • iOS: Gehen Sie zu Build Settings > iOS.

    • Android: Gehen Sie zu Android > Player Settings > Other Settings.

    Die ID Ihres Unity-Projekts ist der Wert Bundle Identifier (Beispiel-ID: com.yourcompany.yourproject).

  5. (Optional) Geben Sie die plattformspezifischen Aliasnamen Ihres Unity-Projekts ein.
    Diese Aliasse sind interne, praktische Kennungen und sind nur für Sie in der Firebase-Konsole sichtbar.

  6. Klicken Sie auf App registrieren.

Schritt 3: Firebase-Konfigurationsdateien hinzufügen

  1. Rufen Sie Ihre plattformspezifischen Firebase-Konfigurationsdateien im Firebase-Konsoleneinrichtungsworkflow ab.

    • Für iOS: Klicken Sie auf GoogleService-Info.plist herunterladen.

    • Für Android: Klicken Sie auf google-services.json herunterladen.

    • Die Firebase-Konfigurationsdatei enthält eindeutige, aber nicht verborgene Kennungen für Ihr Projekt und Ihre App. Weitere Informationen zu dieser Konfigurationsdatei finden Sie unter Firebase-Projekte.

    • Sie können Ihre Firebase-Konfigurationsdatei jederzeit wieder herunterladen.

    • Achten Sie darauf, dass der Name der Konfigurationsdatei keine zusätzlichen Zeichen wie (2) enthält.

  2. Öffnen Sie das Fenster Project Ihres Unity-Projekts und verschieben Sie die Konfigurationsdatei(en) in den Ordner Assets.

  3. Klicken Sie in der Firebase-Konsole im Einrichtungs-Workflow auf Weiter.

Schritt 4: Firebase Unity SDKs hinzufügen

  1. Klicken Sie in der Firebase-Konsole auf Firebase Unity SDK herunterladen und entpacken Sie das SDK dann an einem geeigneten Ort.

    • Sie können das Firebase Unity SDK jederzeit wieder herunterladen.

    • Das Firebase Unity SDK ist nicht plattformspezifisch.

  2. Rufen Sie in Ihrem geöffneten Unity-Projekt Assets > Import Package > Custom Package auf.

  3. Wählen Sie im entpackten SDK die unterstützten Firebase-Produkte aus, die Sie in Ihrer App verwenden möchten.

    • 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. Wenn Sie beispielsweise Firebase Authentication und Firebase Realtime Database verwenden möchten, fügen Sie Folgendes hinzu:
      FirebaseAuth.unitypackage und FirebaseDatabase.unitypackage

    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:
    FirebaseAuth.unitypackage und FirebaseDatabase.unitypackage

  4. Klicken Sie im Fenster Import Unity Package (Unity-Paket importieren) auf Import (Importieren).

  5. Klicken Sie in der Firebase-Konsole im Einrichtungs-Workflow auf Weiter.

Schritt 5: Anforderungen an die Version der Google Play-Dienste bestätigen

Für einige Produkte im Firebase Unity SDK for Android ist Google Play services erforderlich. Weitere Informationen Google Play services muss auf dem neuesten Stand sein, bevor diese Produkte verwendet werden können.

Fügen Sie am Anfang Ihrer Anwendung die folgende using-Anweisung und den Initialisierungscode hinzu. Sie können vor dem Aufrufen anderer Methoden im SDK prüfen, ob Google Play services die erforderliche Version hat, und sie gegebenenfalls aktualisieren.

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 Probleme bei der Einrichtung haben, lesen Sie die Unity-Fehlerbehebung und ‑FAQs.

Desktop-Workflow einrichten (Beta)

Wenn Sie ein Spiel entwickeln, ist es oft viel einfacher, es zuerst im Unity-Editor und auf Desktop-Plattformen zu testen und es dann später im Entwicklungszyklus auf Mobilgeräten bereitzustellen und zu testen. Um diesen Workflow zu unterstützen, stellen wir eine Teilmenge der Firebase Unity SDKs zur Verfügung, die unter Windows, macOS und Linux sowie im Unity-Editor ausgeführt werden können.

  1. Richten Sie ein Unity-Projekt für eine Desktop-Plattform ein, indem Sie der Anleitung für eine mobile Plattform folgen (beginnen Sie mit dem Schritt App bei Firebase registrieren oben).

  2. Führen Sie Ihr Unity-Projekt in der Unity-IDE aus oder wählen Sie aus, dass Ihr Unity-Projekt für Desktop erstellt werden soll.

  3. 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-Plug-ins verwendet werden kann.

    1. Wenn Sie ein FirebaseApp erstellen, das vom Editor verwendet wird, verwenden Sie nicht die Standardinstanz.

    2. Geben Sie stattdessen einen eindeutigen Namen für den FirebaseApp.Create()-Aufruf an.

      Das ist wichtig, um Konflikte zwischen den Optionen der Instanz, die von der Unity IDE verwendet wird, und der Instanz, die von Ihrem Unity-Projekt verwendet wird, 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
Firebase AI Logic FirebaseAI.unitypackage
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 Desktop

Das Firebase Unity SDK bietet Unterstützung für Desktop-Arbeitsabläufe für eine Teilmenge 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 (Desktop) Unity-Paket
Firebase AI Logic FirebaseAI.unitypackage
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 verbleibenden Desktop-Bibliotheken als Stub-Implementierungen (nicht funktionsfähig) für Windows, macOS und Linux bereit. Daher müssen Sie keinen Code bedingt kompilieren, um ihn auf dem Desktop auszuführen.

Nächste Schritte