Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

Firebase zu Ihrem Unity-Projekt hinzufügen

Schalten Sie Ihre Unity Spiele mit unseren Firebase Unity SDKs.

Um zu zeigen , wie einfach es ist Firebase in der Unity - Projekt zu stecken, haben wir ein Probe - Spiel, MechaHamster, dass Sie von GitHub herunterladen können, die App Store und im Google Play Store.

MechaHamster (GitHub)

MechaHamster (App-Store)

MechaHamster (Playstore)


Erfahren Sie mehr Informationen über Einschalten Ihre Spiele mit Firebase in unserem Firebase Spiele Seite .

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

Voraussetzungen

  • Installieren Sie Unity 2017.4 oder höher. Frühere Versionen können ebenfalls kompatibel sein, werden jedoch nicht aktiv unterstützt.

  • (IOS nur) Installieren der folgenden Eigenschaften :

    • Xcode 9.4.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 10 oder höher
    • Für Android - Ziele API - Ebene 16 (Jelly Bean) oder höher

  • Richten Sie ein physisches Gerät ein oder verwenden Sie einen Emulator, um Ihre App auszuführen.

    • Für iOS - Stellen Sie den iOS Simulator ein physisches iOS - Gerät oder aufbrauchen.

    • Für Android - Emulatoren müssen ein Emulator Bild mit Google Play verwenden.

Wenn Sie nicht bereits über ein Unity - Projekt haben und wollen nur ein Produkt Firebase auszuprobieren, können Sie einen unserer Download quickstart Proben .

Schritt 1: Firebase Projekt anlegen

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 verstehen Firebase Projekte mehr über Projekte Firebase zu lernen.

Schritt 2: Registrieren Sie Ihre App mit Firebase

Sie können eine oder mehrere Apps oder Spiele registrieren, um sich mit Ihrem Firebase-Projekt zu verbinden.

  1. Gehen Sie auf die Firebase Konsole .

  2. Im Zentrum des Projekts Übersichtsseite finden Sie im Unity - Symbol ( ) , um den Setup - Workflow zu starten.

    Wenn Sie bereits eine App zu Ihrem Firebase - Projekt hinzugefügt haben, klicken Sie App Fügen Sie die Plattform - Optionen 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 plattformspezifische(n) ID(s) Ihres Unity-Projekts ein.

    • Für iOS - Geben Sie Ihr iOS - ID des Unity - Projektes in dem iOS - Bundle - ID - Feld.

    • Für Android - Geben Sie Ihr Android - ID des Unity - Projektes im Android Paketnamen Feld.
      Die Begriffe Paketnamen und Anwendungs - ID werden oft synonym verwendet.

  5. (Optional) Geben Sie Ihre Unity - Projekt plattformspezifischen Spitznamen (s).
    Diese Spitznamen sind interne, praktische Kennungen und sind nur für Sie in der Firebase-Konsole sichtbar.

  6. Klicken Sie auf Registrieren App.

Schritt 3: Hinzufügen Firebase Konfigurationsdateien

  1. Rufen Sie Ihre plattformspezifische(n) Firebase-Konfigurationsdatei(en) im Einrichtungsworkflow der Firebase-Konsole ab.

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

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

  2. Öffnen Sie das Projektfenster des Unity - Projekt, dann bewegen Sie die Konfigurationsdatei (en) in den Assets Ordner.

  3. Zurück in der Firebase - Konsole im Setup - Workflow, klicken Sie auf Weiter.

Schritt 4: Firebase Unity SDKs

  1. In der Firebase - Konsole, klicken Sie auf Download Firebase Unity SDK, dann entpacken Sie das SDK irgendwo bequem.

    • Sie können den Download Firebase Unity SDK jederzeit wieder.

    • Das Firebase Unity SDK ist nicht plattformspezifisch.

  2. In Ihrem offenen Unity Projekt Navigieren zu Assets> Import Package> Benutzerdefinierte Package.

  3. Aus dem entpackten SDK, wählen Sie die unterstützten Produkte Firebase , dass Sie in Ihrer Anwendung verwenden möchten.

    Analytics aktiviert

    • Fügen Sie die Firebase - Paket für Google Analytics: 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 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. So verwenden Sie beispielsweise Firebase Authentication und Firebase Realtime Database:
    FirebaseAuth.unitypackage und FirebaseDatabase.unitypackage

  4. Im Importfenster Unity - Paket, klicken Sie auf Importieren.

  5. Zurück in der Firebase - Konsole im Setup - Workflow, klicken Sie auf Weiter.

Schritt 5: Bestätigen Sie Google Play - Dienste Version Anforderungen

Die Firebase Unity - SDK für Android erfordert Google Play - Dienste , die up-to-date sein muss , bevor das SDK verwendet werden kann.

Fügen Sie den folgenden Code zu Beginn Ihrer Anwendung 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 fertig! Ihr Unity-Projekt ist registriert und für die Verwendung von Firebase konfiguriert.

Wenn Sie Probleme haben, aufgebaut zu werden , besuchen aber die Einheit zur Fehlerbehebung & FAQ .

Richten Sie einen Desktop - Workflow (beta)

Wenn Sie ein Spiel erstellen, ist es oft viel einfacher, Ihr Spiel zuerst im Unity-Editor und auf Desktop-Plattformen zu testen und dann später in der Entwicklung auf mobilen Geräten bereitzustellen und zu testen. Um diesen Workflow zu unterstützen, bieten wir eine Teilmenge der Firebase Unity SDKs , die auf Windows, MacOS, Linux laufen kann, und aus dem Unity - Editor.

  1. Richten Sie ein Desktop-Plattform Unity - Projekt , indem Sie die gleichen Anweisungen wie für eine mobile Plattform (beginnen mit dem Register der App mit Firebase Schritt oben).

  2. Führen Sie Ihr Unity - Projekt in der Unity IDE oder wählen Sie Ihr Unity - Projekt für den Desktop zu bauen.

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

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

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

    2. Stattdessen bieten einen eindeutigen Namen der FirebaseApp.Create() Aufruf.

      Dies ist wichtig, um einen Konflikt in den Optionen 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 .

Die Firebase Unity SDK unterstützt die folgenden Firebase Produkte auf iOS und Android:

Firebase-Produkt Einheitspaket
AdMob Separat im AdMob Unity-Plug-in verteilt
Analytik FirebaseAnalytics.unitypackage
Authentifizierung FirebaseAuth.unitypackage
Cloud Firestor (beta) 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-Konfiguration FirebaseRemoteConfig.unitypackage
(empfohlen) FirebaseAnalytics.unitypackage

Unterstützte Firebase-Produkte (Desktop)

Die Firebase Unity SDK enthält Desktop - Workflow - Unterstützung für eine Teilmenge von Produkten, so dass bestimmte Teile Firebase im Editor Unity verwendet werden und im Stand - Alone - Desktop basiert auf Windows, MacOS und Linux.

Firebase-Produkt (Desktop) Einheitspaket
Authentifizierung FirebaseAuth.unitypackage
Cloud-Funktionen FirebaseFunctions.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Cloud-Speicher FirebaseStorage.unitypackage
Echtzeit-Datenbank FirebaseDatabase.unitypackage
Remote-Konfiguration FirebaseRemoteConfig.unitypackage

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

Nächste Schritte