Dodaj Firebase do projektu Unity

Ulepsz swoje gry na Unity dzięki naszym pakietom 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 2021 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,
  • CocoaPods w wersji 1.12.0 lub nowszej,

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

  • Na urządzeniu z 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.

    Czy chcesz użyć aplikacji Cloud Messaging?

    W przypadku Cloud Messaging na iOS lub tvOS wymagania wstępne są następujące:

    • Skonfiguruj urządzenie fizyczne.
    • Uzyskaj klucz uwierzytelniania usługi Apple Push Notification dla swojego konta dewelopera Apple.
    • Włącz powiadomienia push w XCode w sekcji App > Capabilities (Aplikacja > Możliwości).

  • 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ładów z krótkiego przewodnika.

Krok 1. Utwórz projekt w Firebase

Zanim dodasz Firebase do projektu Unity, musisz utworzyć projekt Firebase, który połączysz 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. W centrum strony przeglądu projektu kliknij ikonę Unity (plat_unity), aby uruchomić proces konfiguracji.

   Jeśli masz już aplikację dodaną 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 – wpisz identyfikator iOS projektu Unity w polu Identyfikator pakietu na iOS.

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

   Gdzie znajdziesz identyfikator projektu Unity?

   Otwórz projekt Unity w środowisku IDE Unity, a następnie przejdź do sekcji ustawień każdej platformy:

   • Na urządzeniu z iOS – kliknij Build Settings > iOS (Ustawienia kompilacji > iOS).

   • Android – kliknij Android > Player Settings > Other Settings (Android > Ustawienia odtwarzacza > Inne ustawienia).

   Identyfikator projektu Unity to wartość Identyfikator pakietu (przykładowy identyfikator: com.yourcompany.yourproject).

5. (Opcjonalnie) Wpisz nazwy projektu Unity na poszczególnych platformach.
   Te nazwy to wewnętrzne, wygodne identyfikatory, które 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.

   Co musisz wiedzieć o tym pliku konfiguracji?

   • Plik konfiguracyjny Firebase zawiera unikalne, ale nie tajne identyfikatory projektu i aplikacji. Więcej informacji o tym pliku konfiguracyjnym znajdziesz w artykule Informacje o projektach Firebase.

   • W każdej chwili możesz ponownie pobrać plik konfiguracji Firebase.

   • Sprawdź, czy nazwa pliku konfiguracyjnego nie zawiera dodatkowych znaków, np. (2).

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 Firebase Unity SDK

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

   • Pakiet SDK Firebase Unity możesz pobrać ponownie 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 rozpakowanego 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. Na przykład, aby używać Firebase Authentication i Firebase Realtime Database:
     FirebaseAuth.unitypackage i FirebaseDatabase.unitypackage

   Analytics nie jest włączony

   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. Zanim wywołasz inne metody 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.
  }
});

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 przetestować ją najpierw 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 IDE Unity 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:

Dostępne biblioteki Firebase na komputery

Pakiet SDK Firebase Unity obsługuje procesy robocze na komputerach 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.

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

• Zapoznaj się z przykładowymi aplikacjami Firebase.

• Przygotuj się do opublikowania aplikacji:

  • Skonfiguruj alerty dotyczące budżetu dla projektu w konsoli Google Cloud.
  • Monitoruj panel Korzystanie i rozliczenia w konsoli Firebase, aby uzyskać ogólny obraz wykorzystania projektu w różnych usługach Firebase.
  • Zapoznaj się z listą kontrolną dotyczącą uruchamiania Firebase.

• Masz problemy z Firebase i projektem Unity? Zapoznaj się z najczęstszymi pytaniami i rozwiązaniami problemów z Unity.