Dodaj Firebase do projektu Unity

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

Aby pokazać, jak łatwo jest zintegrować Firebase z projektem Unity, stworzyliśmy przykładową grę MechaHamster. Jeśli chcesz wypróbować dodawanie Firebase do gry, użyj wersji początkowej, która jest dostępna na GitHubie. Jeśli chcesz zobaczyć 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 naszej stronie poświęconej grom w Firebase.

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

Wymagania wstępne

  • Zainstaluj Unity 2021 LTS lub nowszą. Obsługa Unity 2020 jest uznawana za przestarzałą i po kolejnej głównej wersji nie będzie już aktywnie obsługiwana. Wcześniejsze wersje mogą być również zgodne, ale nie będą aktywnie obsługiwane.

  • (Tylko platformy Apple) Zainstaluj te elementy:

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

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

    • iOS – kierowanie na urządzenia z systemem iOS 13 lub nowszym.
    • tvOS – docelowa wersja tvOS to 13 lub nowsza.
    • W przypadku Androida – kierowanie na interfejs API na poziomie 21 (Lollipop) lub wyższym.

  • Skonfiguruj urządzenie fizyczne lub użyj emulatora, aby uruchomić aplikację.

    • W przypadku platform Apple – skonfiguruj urządzenie fizyczne lub użyj symulatora iOS lub tvOS.

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

Jeśli nie masz jeszcze projektu Unity, a chcesz tylko wypróbować usługę Firebase, możesz pobrać jeden z naszych przykładów kodu umożliwiających szybkie rozpoczęcie pracy.

Krok 1. Utwórz projekt Firebase

Zanim dodasz Firebase do projektu Unity, musisz utworzyć projekt Firebase, aby połączyć go z projektem Unity. Więcej informacji o projektach Firebase znajdziesz w artykule Projekty Firebase.

Krok 2. Zarejestruj aplikację w Firebase

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

  1. Otwórz Firebasekonsolę.

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

    Jeśli masz już aplikację w projekcie Firebase, kliknij Dodaj aplikację, aby wyświetlić opcje platformy.

  3. Wybierz cel kompilacji projektu Unity, który chcesz zarejestrować. Możesz też zarejestrować oba cele jednocześnie.

  4. Wpisz identyfikatory projektu Unity dla poszczególnych platform.

    • iOS – w polu Identyfikator pakietu na iOS wpisz identyfikator projektu Unity na iOS.

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

  5. (Opcjonalnie) Wpisz pseudonimy specyficzne dla platformy w projekcie Unity.
    Te pseudonimy są wewnętrznymi identyfikatorami ułatwiającymi pracę i są widoczne tylko w Firebase konsoli.

  6. Kliknij Zarejestruj aplikację.

Krok 3. Dodaj pliki konfiguracyjne Firebase

  1. Uzyskaj pliki konfiguracyjne Firebase dla konkretnej platformy w ramach Firebasekonfiguracji konsoli.

    • iOS – kliknij Pobierz GoogleService-Info.plist.

    • Android – kliknij Download google-services.json (Pobierz google-services.json).

  2. Otwórz okno Project w projekcie Unity, a następnie przenieś pliki konfiguracyjne do folderu Assets.

  3. Wróć do konsoli Firebase i w przepływie pracy konfiguracji kliknij Dalej.

Krok 4. Dodaj pakiety SDK Firebase Unity

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

    • W dowolnym momencie możesz ponownie pobrać Firebase Unity SDK.

    • Pakiet SDK Firebase Unity nie jest przeznaczony dla konkretnej platformy.

  2. W otwartym projekcie Unity kliknij Assets (Zasoby) > Import Package (Importuj pakiet) > Custom Package (Własny pakiet).

  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 innych usług Firebase, których chcesz używać w aplikacji. Na przykład, aby używać Firebase Authentication i Firebase Realtime Database:
      FirebaseAuth.unitypackage i FirebaseDatabase.unitypackage

    Nie włączono Analytics

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

  4. W oknie Import Unity Package (Importowanie pakietu dla Unity) kliknij Import (Importuj).

  5. Wróć do konsoli Firebase i w przepływie pracy konfiguracji kliknij Dalej.

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

Niektóre usługi w pakiecie Firebase Unity SDK na Androida wymagają Google Play services. Dowiedz się, które usługi mają tę zależność. Aby można było korzystać z tych usług, aplikacja Google Play services musi być aktualna.

Dodaj na początku aplikacji ten kod inicjowania i instrukcję using. Przed wywołaniem innych metod w pakiecie SDK możesz sprawdzić i opcjonalnie zaktualizować Google Play services 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. Projekt Unity jest zarejestrowany i skonfigurowany do korzystania z Firebase.

Jeśli masz problemy z konfiguracją, zapoznaj się z najczęstszymi pytaniami i odpowiedziami dotyczącymi rozwiązywania problemów z Unity.

Konfigurowanie przepływu pracy na komputerze (wersja beta)

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

  1. Skonfiguruj projekt Unity na platformę desktopową, postępując zgodnie z tymi samymi instrukcjami co w przypadku platformy mobilnej (zacznij od kroku Rejestrowanie aplikacji w Firebase powyżej).

  2. Uruchom projekt Unity w środowisku IDE Unity lub wybierz opcję utworzenia projektu Unity na komputer.

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

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

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

    2. Zamiast tego podaj unikalną nazwę wywołania FirebaseApp.Create().

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

Obsługiwane usługi Firebase

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

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 Dystrybuowane oddzielnie w AdMob wtyczce 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 obejmuje obsługę przepływu pracy na komputerze w przypadku podzbioru usług, co umożliwia korzystanie z określonych części Firebase w edytorze Unity i w samodzielnych kompilacjach na komputery z systemem Windows, macOS i Linux.

Usługa Firebase (na komputerze) 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 w postaci implementacji typu stub (niefunkcjonalnych), aby ułatwić tworzenie aplikacji na Windowsa, macOS i Linuksa. Dlatego nie musisz warunkowo kompilować kodu, aby kierować go na komputery.

Dalsze kroki