Dodaj Firebase do projektu Unity

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

Aby pokazać, jak łatwo jest podłączyć Firebase do projektu Unity, stworzyliśmy przykładową grę MechaHamster. Jeśli chcesz spróbować dodać Firebase do gry, użyj wersji początkowej, która jest dostępna na GitHubie. Jeśli chcesz korzystać z pełnej wersji, sprawdź wersje dostępne 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 Firebase poświęconej grom.

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

Wymagania wstępne

  • Zainstaluj Unity 2022 LTS lub nowszą wersję. Wcześniejsze wersje też mogą być zgodne, ale nie będą aktywnie obsługiwane.

  • (Tylko platformy Apple) Zainstaluj te elementy:

    • Xcode 26.2 lub nowszy,

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

    • For iOS – kieruje reklamy na urządzenia z systemem iOS 15 lub nowszym.
    • tvOS – kierowanie na tvOS 15 lub nowszy.
    • Android – kierowanie na interfejs API na poziomie 24 (Nougat) lub wyższym.

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

    • Platformy 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 i chcesz tylko wypróbować usługę Firebase, możesz pobrać jeden z naszych przykładowych projektów z krótkim wprowadzeniem.

Krok 1. Utwórz projekt w Firebase.

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

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. Na środku strony Przegląd projektu kliknij ikonę Unity (), aby uruchomić proces konfiguracji.

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

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

  4. Wpisz identyfikatory projektu Unity na poszczególnych platformach.

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

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

  5. Opcjonalnie: wpisz nazwy projektu Unity na poszczególnych platformach.
    Te nazwy są wewnętrznymi, wygodnymi identyfikatorami i są widoczne tylko dla Ciebie w konsoli Firebase.

  6. Kliknij Zarejestruj aplikację.

Krok 3. Dodaj pliki konfiguracji Firebase

  1. Uzyskaj pliki konfiguracji Firebase dla konkretnej platformy w procesie konfiguracji konsoli Firebase.

    • iOS – kliknij Pobierz GoogleService-Info.plist.

    • W przypadku Androida – kliknij Pobierz google-services.json.

  2. Otwórz okno Project (Projekt) projektu Unity, a następnie 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.

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

    • Pakiet SDK Firebase Unity nie jest przeznaczony na konkretną platformę.

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

  3. Z wyodrębnionego pakietu SDK wybierz obsługiwane usługi Firebase, których chcesz używać w aplikacji.

    Model Analytics został włączony

    • Dodaj pakiet Firebase dla Google Analytics: FirebaseAnalytics.unitypackage
    • Dodaj pakiety innych usług Firebase, których chcesz używać w aplikacji. Jeśli na przykład chcesz 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. Jeśli na przykład chcesz 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 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 usługi mają tę zależność. Aby można było korzystać z tych usług, Google Play services musi być aktualny.

Dodaj na początku aplikacji instrukcję using i kod inicjowania. Możesz sprawdzić i opcjonalnie zaktualizować Google Play services do wymaganej wersji przed wywołaniem innych metod w pakiecie SDK.

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

To już wszystko Twój projekt Unity jest zarejestrowany i skonfigurowany do korzystania z Firebase.

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

Konfigurowanie przepływu pracy na komputerze (beta)

Podczas tworzenia gry często znacznie łatwiej jest najpierw przetestować ją w edytorze Unity i na platformach komputerowych, a dopiero 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ą, postępując zgodnie z tymi samymi instrukcjami co w przypadku platformy mobilnej (zacznij od kroku Zarejestruj aplikację w Firebase powyżej).

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

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

    Pakiet SDK Firebase Unity można też uruchomić w trybie edycji Unity, co umożliwia korzystanie z niego we wtyczkach edytora.

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

    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 Unity znajdziesz w dokumentacji referencyjnej.

Dostępne biblioteki Firebase na urządzenia mobilne

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

Usługa Firebase Pakiet Unity
AdMob Dystrybuowane osobno we wtyczce 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
Realtime Database FirebaseDatabase.unitypackage
Remote Config FirebaseRemoteConfig.unitypackage
(zalecane) FirebaseAnalytics.unitypackage
WYCOFANE LUB NIEOBSŁUGIWANE BIBLIOTEKI
Dynamic Links FirebaseDynamicLinks.unitypackage
(zalecane) FirebaseAnalytics.unitypackage

thought 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 niektórych części Firebase w edytorze Unity i w samodzielnych kompilacjach na komputery z systemem Windows, macOS i Linux.

Usługa Firebase (komputer) 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 zastępcze (niefunkcjonalne), aby ułatwić tworzenie aplikacji na systemy Windows, macOS i Linux. Dlatego nie musisz kompilować kodu warunkowo, aby kierować reklamy na komputery.

Dalsze kroki