Fügen Sie Ihrem Unity-Projekt Firebase hinzu

Stärken Sie Ihre Unity- Spiele mit unseren Firebase Unity SDKs.

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

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (Play Store)


Weitere Informationen zur Optimierung Ihrer Spiele mit Firebase finden Sie auf unserer Firebase-Spieleseite .

Sie haben 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 sind möglicherweise auch kompatibel, werden jedoch 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.12.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 Android : Emulatoren müssen ein Emulator-Image bei Google Play verwenden.

Wenn Sie noch kein Unity-Projekt haben und einfach nur ein Firebase-Produkt ausprobieren möchten, können Sie eines unserer Schnellstart-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.

  1. Gehen Sie zur Firebase-Konsole .

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

  3. Wählen Sie aus, welches Build-Ziel Ihres Unity-Projekts Sie registrieren möchten, oder Sie können sogar beide Ziele jetzt gleichzeitig registrieren.

  4. Geben Sie die plattformspezifischen ID(s) 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.

  5. (Optional) Geben Sie die plattformspezifischen Spitznamen Ihres Unity-Projekts ein.
    Bei diesen Spitznamen handelt es sich um interne, praktische Kennungen, die nur für Sie in der Firebase-Konsole sichtbar sind.

  6. Klicken Sie auf App registrieren .

Schritt 3 : Firebase-Konfigurationsdateien hinzufügen

  1. Rufen Sie Ihre plattformspezifischen Firebase-Konfigurationsdateien im Einrichtungsworkflow der Firebase-Konsole ab.

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

    • Für Android : Klicken Sie auf „Google-services.json herunterladen“ .

  2. Öffnen Sie das Projektfenster Ihres Unity-Projekts und verschieben Sie dann Ihre Konfigurationsdatei(en) in den Ordner Assets .

  3. Klicken Sie zurück in der Firebase-Konsole im Setup-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 an einem geeigneten Ort.

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

    • Das Firebase Unity SDK ist nicht plattformspezifisch.

  2. Navigieren Sie in Ihrem geöffneten Unity-Projekt zu Assets > Paket importieren > Benutzerdefiniertes Paket .

  3. 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. Um beispielsweise Firebase Authentication und Firebase Realtime Database zu verwenden:
      FirebaseAuth.unitypackage und FirebaseDatabase.unitypackage

    Analytics nicht aktiviert

    Fügen Sie die Pakete für die Firebase-Produkte hinzu, die Sie in Ihrer App verwenden möchten. Um beispielsweise Firebase Authentication und Firebase Realtime Database zu verwenden:
    FirebaseAuth.unitypackage und FirebaseDatabase.unitypackage

  4. Klicken Sie im Fenster „Unity-Paket importieren“ auf „Importieren“ .

  5. 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 die folgende using -Anweisung und den folgenden Initialisierungscode hinzu. Sie können vor dem Aufrufen anderer Methoden im SDK nach Google Play-Diensten suchen und diese optional auf die für das Firebase Unity SDK erforderliche Version 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.
  }
});

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 die Unity-Fehlerbehebung und FAQ .

Einrichten eines Desktop-Workflows ( Beta )

Wenn Sie ein Spiel erstellen, ist es oft viel einfacher, es zunächst im Unity-Editor und auf Desktop-Plattformen zu testen und es später in der Entwicklung auf Mobilgeräten bereitzustellen und zu testen. Um diesen Workflow zu unterstützen, stellen wir eine Teilmenge der Firebase Unity SDKs bereit, die unter Windows, macOS, Linux und im Unity-Editor ausgeführt werden können.

  1. Richten Sie ein Unity-Projekt für die Desktop-Plattform ein, indem Sie die gleichen Anweisungen wie für eine mobile Plattform befolgen (beginnen Sie mit dem Schritt „ Registrieren Sie Ihre App bei Firebase“ oben).

  2. Führen Sie Ihr Unity-Projekt in der Unity-IDE aus oder erstellen Sie Ihr Unity-Projekt für den Desktop .

  3. (Optional) Führen Sie Ihr Unity-Projekt im Bearbeitungsmodus aus.

    Das Firebase Unity SDK kann auch im Bearbeitungsmodus von Unity ausgeführt werden, was die Verwendung in Editor-Plugins ermöglicht.

    1. Wenn Sie eine vom Editor verwendete FirebaseApp erstellen, verwenden Sie nicht die Standardinstanz.

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

Erfahren Sie mehr über die Unity Firebase-Bibliotheken 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
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
Echtzeitdatenbank FirebaseDatabase.unitypackage
Remote-Konfiguration FirebaseRemoteConfig.unitypackage
(empfohlen) FirebaseAnalytics.unitypackage

Verfügbare Firebase-Bibliotheken für den Desktop

Das Firebase Unity SDK umfasst Desktop-Workflow-Unterstützung für eine Untergruppe von Produkten und ermöglicht die Verwendung bestimmter Teile von Firebase im Unity-Editor und in eigenständigen Desktop-Builds unter Windows, macOS und Linux.

Firebase-Produkt (Desktop) Unity-Paket
App-Check FirebaseAppCheck.unitypackage
Authentifizierung FirebaseAuth.unitypackage
Cloud-Funktionen FirebaseFunctions.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Cloud-Speicher FirebaseStorage.unitypackage
Echtzeitdatenbank FirebaseDatabase.unitypackage
Remote-Konfiguration FirebaseRemoteConfig.unitypackage

Firebase stellt die verbleibenden Desktop-Bibliotheken als Stub-Implementierungen (nicht funktionsfähig) zur Verfügung, um die Erstellung für Windows, macOS und Linux zu erleichtern. Daher müssen Sie den Code nicht bedingt kompilieren, um ihn auf den Desktop abzuzielen.

Nächste Schritte