Dodaj Firebase do projektu Unity

Zwiększ skuteczność swoich gier w Unity dzięki pakietom SDK Firebase Unity.

Aby pokazać, jak łatwo można podłączyć Firebase do projektu w Unity, stworzyliśmy przykładową grę o nazwie MechaHamster. Jeśli chcesz spróbować dodać Firebase do gry, użyj wersji startowej, która jest dostępna na GitHubie. Jeśli potrzebujesz ukończonej wersji, sprawdź wersje w App Store lub Sklepie Google Play.

MechaHamster (GitHub)

MechaHamster (sklep z aplikacjami)

MechaHamster (Sklep Play)


Więcej informacji o wzbogacaniu gier dzięki Firebase znajdziesz na stronie gier w Firebase.

Masz już konto Firebase w projekcie w Unity? Upewnij się, że używasz najnowszej wersji pakietu SDK Firebase Unity.

Wymagania wstępne

  • Zainstaluj Unity w wersji 2019.1 lub nowszej. Wcześniejsze wersje również mogą być zgodne, ale nie będą aktywnie obsługiwane. Obsługa Unity 2019.1 jest uważana za wycofaną i nie będzie aktywnie obsługiwana po kolejnej dużej wersji.

  • (Tylko platformy Apple) Zainstaluj te elementy:

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

  • Sprawdź, czy Twój projekt w Unity spełnia te wymagania:

    • iOS – jest kierowana na system iOS 11 lub nowszy.
    • tvOS – jest kierowana na system tvOS w wersji 12 lub nowszej
    • Android – kierowanie na interfejs API na poziomie 19 (KitKat) lub wyższym

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

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

    • Android – Emulatory muszą używać obrazu emulatora w Google Play.

Jeśli nie masz jeszcze projektu Unity, a chcesz tylko wypróbować usługę Firebase, możesz pobrać krótkie wprowadzenie (przykłady).

Krok 1. Utwórz projekt Firebase

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

Krok 2. Zarejestruj aplikację w Firebase

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

  1. Otwórz konsolę Firebase.

  2. Na środku strony przeglądu projektu kliknij ikonę Unity (), aby uruchomić przepływ pracy konfiguracji.

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

  3. Wybierz środowisko docelowe kompilacji swojego projektu w Unity, które chcesz zarejestrować. Możesz też zarejestrować oba środowiska docelowe jednocześnie.

  4. Wpisz identyfikatory projektów Unity dla danej platformy.

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

    • Na urządzeniu z Androidem – w polu Nazwa pakietu na Androida wpisz identyfikator Androida projektu Unity.
      Terminy nazwa pakietu i identyfikator aplikacji są często używane wymiennie.

  5. (Opcjonalnie) Wpisz pseudonimy związane z platformą projektu Unity.
    Te pseudonimy 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 dotyczące konkretnej platformy w procesie konfiguracji konsoli Firebase.

    • iOS – kliknij Pobierz GoogleService-Info.plist.

    • Android – kliknij Pobierz google-services.json.

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

  3. Gdy wrócisz do konsoli Firebase, w procesie konfiguracji kliknij Dalej.

Krok 4. Dodaj pakiety SDK Firebase Unity

.

  1. W konsoli Firebase kliknij Pobierz pakiet Firebase Unity SDK i rozpakuj pakiet SDK w dowolnym miejscu.

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

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

  2. W otwartym projekcie Unity przejdź do Assets (Zasoby) i wybierz Import Package (Importuj pakiet) > Custom Package (Pakiet niestandardowy).

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

    Analityka włączona

    • Dodaj pakiet Firebase dla Google Analytics: FirebaseAnalytics.unitypackage
    • Dodaj pakiety wszystkich innych usług Firebase, których chcesz używać w swojej aplikacji. Aby np. skorzystać z Uwierzytelniania Firebase i Bazy danych czasu rzeczywistego Firebase:
      FirebaseAuth.unitypackage i FirebaseDatabase.unitypackage

    Statystyki nie są włączone

    Dodaj pakiety usług Firebase, których chcesz używać w swojej aplikacji. Aby np. korzystać z Uwierzytelniania Firebase i Bazy danych czasu rzeczywistego Firebase:
    FirebaseAuth.unitypackage i FirebaseDatabase.unitypackage

  4. W oknie Import Unity Package (Importuj pakiet Unity) kliknij Import (Importuj).

  5. Gdy wrócisz do konsoli Firebase, w procesie konfiguracji kliknij Dalej.

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

Pakiet SDK Firebase Unity SDK na Androida wymaga Usług Google Play, które muszą być aktualne, aby można było korzystać z pakietu SDK.

Na początku aplikacji dodaj instrukcję using i kod inicjowania. Możesz sprawdzić, czy Usługi Google Play są w wersji wymaganej przez pakiet Firebase Unity SDK, i opcjonalnie zaktualizować je do wersji wymaganej 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.
  }
});

Wszystko gotowe. Twój projekt w Unity jest zarejestrowany i skonfigurowany do używania Firebase.

Jeśli masz problemy z konfiguracją, wejdź na stronę Rozwiązywanie problemów z Unity i najczęstsze pytania.

Konfigurowanie przepływu pracy na komputerze (beta)

Gdy tworzysz grę, często łatwiej jest najpierw przetestować ją w edytorze Unity i na platformie komputerowej, a później wdrożyć i przetestować ją na urządzeniach mobilnych. Aby ułatwić ten przepływ pracy, 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 w Unity na komputerze, postępując zgodnie z tymi samymi instrukcjami co w przypadku platformy mobilnej (zacznij od kroku Zarejestruj aplikację w Firebase powyżej).

  2. Uruchom swój projekt Unity w IDE Unity lub wybierz go, by utworzyć projekt Unity na komputer.

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

    Pakiet Firebase Unity SDK można też uruchomić w trybie edycji Unity, co umożliwia użycie go we wtyczkach edytora.

    1. Gdy tworzysz obiekt FirebaseApp używany przez edytor, nie używaj instancji domyślnej.

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

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

Obsługiwane usługi Firebase

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

Dostępne biblioteki Firebase na urządzenia mobilne

Pakiet SDK Firebase Unity obsługuje następujące usługi Firebase na urządzeniach Apple i Android:

Usługa Firebase Pakiet Unity
AdMob Rozpowszechniane oddzielnie we wtyczce AdMob Unity
Analytics FirebaseAnalytics.unitypackage
Sprawdzanie aplikacji FirebaseAppCheck.unitypackage
Uwierzytelnianie FirebaseAuth.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Funkcje Cloud FirebaseFunctions.unitypackage
Komunikacja w chmurze FirebaseMessaging.unitypackage
(zalecane) FirebaseAnalytics.unitypackage
Cloud Storage, FirebaseStorage.unitypackage
Crashlytics FirebaseCrashlytics.unitypackage
(zalecane) FirebaseAnalytics.unitypackage
Linki dynamiczne FirebaseDynamicLinks.unitypackage
(zalecane) FirebaseAnalytics.unitypackage
Baza danych czasu rzeczywistego FirebaseDatabase.unitypackage
Zdalna konfiguracja FirebaseRemoteConfig.unitypackage
(zalecane) FirebaseAnalytics.unitypackage

Dostępne biblioteki Firebase na komputery

Pakiet Firebase Unity SDK obejmuje obsługę przepływu pracy na komputerach w przypadku podzbioru usług, dzięki czemu niektóre części Firebase można używać w edytorze Unity oraz w samodzielnych kompilacjach na komputery z systemami Windows, macOS i Linux.

Usługa Firebase (komputery) Pakiet Unity
Sprawdzanie aplikacji FirebaseAppCheck.unitypackage
Uwierzytelnianie FirebaseAuth.unitypackage
Funkcje Cloud FirebaseFunctions.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Cloud Storage, FirebaseStorage.unitypackage
Baza danych czasu rzeczywistego FirebaseDatabase.unitypackage
Zdalna konfiguracja FirebaseRemoteConfig.unitypackage

Dla wygody użytkowników Firebase udostępnia pozostałe biblioteki na komputery jako wersje skrócone (niefunkcjonalne) podczas tworzenia aplikacji na systemy Windows, macOS i Linux. Dzięki temu nie musisz warunkowo kompilować kodu kierowanego na komputer.

Dalsze kroki