Dodaj Firebase do projektu Unity

Wzbogać swoje gry Unity za pomocą naszych pakietów SDK Firebase Unity.

Aby pokazać, jak łatwo można podłączyć Firebase do projektu Unity, stworzyliśmy przykładową grę MechaHamster. Jeśli chcesz dodać Firebase do gry, użyj wersji startowej dostępnej na GitHub. Jeśli chcesz mieć gotową wersję, sprawdź wersje w App Store lub Google Play Store.

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (Sklep Play)


Więcej informacji o ulepszaniu gier za pomocą Firebase znajdziesz na stronie z grami Firebase.

Czy Firebase został już dodany do projektu Unity? Upewnij się, że używasz najnowszej wersji pakietu SDK Firebase Unity.

Wymagania wstępne

  • Zainstaluj Unity 2021 LTS lub nowszą. Obsługa Unity 2020 została wycofana i nie będzie już aktywnie obsługiwana po następnej dużej aktualizacji. Wcześniejsze wersje mogą być zgodne, ale nie będą aktywnie obsługiwane.

  • (Dotyczy tylko platform Apple) Zainstaluj te elementy:

    • Xcode 13.3.1 lub nowsza
    • CocoaPods w wersji 1.12.0 lub nowszej

  • Upewnij się, że Twój projekt Unity spełnia te wymagania:

    • Na urządzeniach z iOS – wersja na iOS 13 lub nowszy
    • W przypadku tvOS: docelowy tvOS 13 lub nowszy.
    • Na Androida – kieruj aplikację na poziom API 21 (Lollipop) lub wyższy.

  • Skonfiguruj fizyczne urządzenie lub uruchom aplikację w emulatorze.

    • Na platformach Apple – skonfiguruj fizyczne urządzenie lub użyj symulatora iOS lub tvOS.

    • Android – emulatory muszą używać obrazu z Google Play.

Jeśli nie masz jeszcze projektu Unity, ale chcesz wypróbować produkt Firebase, możesz pobrać jeden z naszych próbnych projektów kodu.

Krok 1. Utwórz projekt Firebase

Zanim dodasz Firebase do projektu Unity, musisz utworzyć projekt Firebase, który połączysz z projektem Unity. Więcej informacji o projektach Firebase znajdziesz w artykule Projekty Firebase – informacje ogólne.

Krok 2. Zarejestruj aplikację w Firebase

Możesz zarejestrować co najmniej 1 aplikację lub grę, aby połączyć ją z projektem Firebase.

  1. Otwórz konsolę Firebase.

  2. W centrum strony „Opis” projektu kliknij ikonę Unity (), aby uruchomić proces konfiguracji.

    Jeśli aplikacja została już dodana do projektu Firebase, kliknij Dodaj aplikację, aby wyświetlić opcje platformy.

  3. Wybierz cel kompilacji projektu Unity, który chcesz zarejestrować, lub wybierz opcję rejestracji obu celów jednocześnie.

  4. Wpisz identyfikatory platformy swojego projektu Unity.

    • W przypadku iOS: w polu Identyfikator pakietu na iOS wpisz identyfikator iOS Twojego projektu Unity.

    • Android – w polu Nazwa pakietu Androida wpisz identyfikator Androida Twojego projektu Unity.
      Terminy nazwa pakietu i identyfikator aplikacji są często używane zamiennie.

  5. (Opcjonalnie) Wpisz pseudonimy platformowe projektu Unity.
    Te pseudonimy to wewnętrzne identyfikatory ułatwiające pracę, które są widoczne tylko w konsoli Firebase.

  6. Kliknij Zarejestruj aplikację.

Krok 3. Dodaj pliki konfiguracji Firebase

  1. Pobierz pliki konfiguracji Firebase dla poszczególnych platform w procesie konfiguracji konsoli Firebase.

    • iOS – kliknij Pobierz plik GoogleService-Info.plist.

    • Android: kliknij Pobierz google-services.json.

  2. Otwórz okno Projekt w projekcie Unity, a potem przenieś pliki konfiguracji do folderu Assets.

  3. Wróć do konsoli Firebase i w procesie konfiguracji kliknij Dalej.

Krok 4. Dodaj pakiety SDK Firebase Unity

  1. W konsoli Firebase kliknij Pobierz pakiet SDK Firebase Unity, a następnie rozpakuj pakiet SDK w dogodnym miejscu.

    • W każdej chwili możesz ponownie pobrać pakiet SDK Firebase Unity.

    • Pakiet SDK Firebase Unity nie jest powiązany z konkretną platformą.

  2. W otwartym projekcie Unity kliknij Zasoby > Importuj pakiet > Pakiet niestandardowy.

  3. W rozpakowanym pakiecie SDK wybierz obsługiwane usługi Firebase, których chcesz używać w aplikacji.

    Włączono Analytics

    • Dodaj pakiet Firebase dla Google Analytics: FirebaseAnalytics.unitypackage
    • Dodaj pakiety wszystkich innych usług Firebase, których chcesz używać w aplikacji. Na przykład, aby używać pakietów Firebase Authentication i Firebase Realtime Database:
      FirebaseAuth.unitypackage i FirebaseDatabase.unitypackage

    Analytics nie jest włączona

    Dodaj pakiety usług Firebase, których chcesz używać w aplikacji. Na przykład, aby użyć usług Firebase Authentication i Firebase Realtime Database:
    FirebaseAuth.unitypackage i FirebaseDatabase.unitypackage

  4. W oknie Importowanie pakietu dla Unity kliknij Importuj.

  5. Wróć do konsoli Firebase i w procesie konfiguracji kliknij Dalej.

Krok 5. Sprawdź wymagania dotyczące wersji Usług Google Play

Niektóre usługi w pakiecie SDK Firebase Unity na Androida wymagają Google Play services. Dowiedz się, które produkty mają tę zależność. Zanim będzie można korzystać z tych usług, musisz zaktualizować aplikację Google Play services.

Na początku aplikacji dodaj instrukcję using i kod inicjowania. Przed wywołaniem innych metod w pakiecie SDK możesz sprawdzić, czy Google Play services jest dostępna (opcjonalnie możesz ją zaktualizować) do wymaganej wersji.

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.
  }
});

Wszystko gotowe. Twój projekt Unity jest zarejestrowany i skonfigurowany do korzystania z Firebase.

Jeśli jednak masz problemy z konfiguracją, zapoznaj się z artykułem Rozwiązywanie problemów z Unity i najczęstsze pytania.

Konfigurowanie przepływu pracy na komputerze (beta)

Podczas tworzenia gry często łatwiej jest ją najpierw przetestować w edytorze Unity i na platformach komputerowych, a później wdrożyć i przetestować na urządzeniach mobilnych. Aby ułatwić ten proces, udostępniamy podzbiór pakietów SDK Firebase Unity, które można uruchamiać w systemach Windows, macOS i Linux oraz w edytorze Unity.

  1. Skonfiguruj projekt Unity na platformę komputerową, wykonując te same instrukcje, co w przypadku platformy mobilnej (zacznij od kroku Zarejestruj aplikację w Firebase).

  2. Uruchom projekt Unity w IDE Unity lub wybierz kompilację projektu Unity na komputera.

  3. (Opcjonalnie) Uruchom projekt Unity w trybie edycji.

    Pakiet SDK Firebase Unity można też uruchomić w trybie edycji Unity, co umożliwia jego używanie w pluginach edytora.

    1. Podczas tworzenia FirebaseApp używanego przez edytor nie używaj instancji domyślnej.

    2. Zamiast tego nadaj wywołaniu FirebaseApp.Create() niepowtarzalną nazwę.

      Jest to ważne, aby uniknąć konfliktu opcji między instancją używaną przez IDE Unity a instancją używaną przez projekt Unity.

Obsługiwane usługi Firebase

Więcej informacji o bibliotekach Firebase w Unity znajdziesz w dokumentacji referencyjnej.

Dostępne biblioteki Firebase na urządzenia mobilne

Pakiet SDK Firebase Unity obsługuje te usługi Firebase na platformach Apple i Android:

Usługa Firebase Pakiet Unity
AdMob rozpowszechniany osobno w ramach wtyczki AdMob Unity;
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
(zalecane) FirebaseAnalytics.unitypackage
Cloud Storage FirebaseStorage.unitypackage
Crashlytics FirebaseCrashlytics.unitypackage
(zalecane) FirebaseAnalytics.unitypackage
Dynamic Links FirebaseDynamicLinks.unitypackage
(zalecane) FirebaseAnalytics.unitypackage
Realtime Database FirebaseDatabase.unitypackage
Remote Config FirebaseRemoteConfig.unitypackage
(zalecane) FirebaseAnalytics.unitypackage

Dostępne biblioteki Firebase na komputery

Pakiet SDK Firebase Unity zawiera obsługę procesów na komputerze w przypadku podzbioru usług, co umożliwia korzystanie z pewnych części Firebase w edytorze Unity oraz w samodzielnych wersjach na komputery z systemem Windows, macOS i Linux.

Usługa Firebase (komputera) Pakiet Unity
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 udostępnia pozostałe biblioteki na komputery jako implementacje w postaci stubów (niefunkcjonalnych) dla wygody podczas kompilowania na potrzeby Windowsa, macOS i Linuxa. Dlatego nie musisz warunkowo kompilować kodu pod kątem komputerów stacjonarnych.

Dalsze kroki