Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

Dodaj Firebase do swojego projektu Unity

Zasilanie zapasowe Unity gier z naszych Firebase Unity SDK.

Aby pokazać, jak łatwo jest podłączyć Firebase do projektu Unity, zrobiliśmy przykładową grę, MechaHamster, które można pobrać z GitHub, App Store i Google Play Store.

Mechahamster (GitHub)

MechaHamster (sklep z aplikacjami)

MechaHamster (Sklep Play)


Dowiedzieć się więcej informacji na temat włączania zapasowych gier z Firebase na naszej stronie gry Firebase .

Dodałeś już Firebase do swojego projektu Unity? Upewnij się, że używasz najnowszej wersji Firebase Unity SDK .

Warunki wstępne

  • Zainstaluj Unity 2017.4 lub nowszy. Wcześniejsze wersje również mogą być kompatybilne, ale nie będą aktywnie wspierane.

  • (tylko iOS) zainstalować następujące:

    • Xcode 9.4.1 lub nowszy
    • CocoaPods 1.10.0 lub nowszy
  • Upewnij się, że Twój projekt Unity spełnia te wymagania:

    • Dla iOS - skierowany iOS 10 lub wyższy
    • Android - cele API poziomie 16 (Jelly Bean) lub nowszym

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

    • Dla iOS - Skonfiguruj fizyczne urządzenie iOS lub skorzystać z symulatora systemu iOS.

    • Dla Androida - emulatory musi użyć obrazu emulatora z Google Play.

Jeżeli nie masz jeszcze projekt Unity i po prostu chcą wypróbować Firebase produkt można pobrać jeden z naszych próbek QuickStart .

Krok 1: Tworzenie projektu Firebase

Zanim dodasz Firebase do projektu Unity, musisz utworzyć projekt Firebase, aby połączyć się z projektem Unity. Wizyta Zrozum Firebase Projekty aby dowiedzieć się więcej o projektach Firebase.

Krok 2: zarejestruj swoją aplikację z Firebase

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

  1. Przejdź do konsoli Firebase .

  2. W środku strony głównej projektu kliknij ikonę Unity ( ), aby uruchomić przepływ pracy instalacji.

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

  3. Wybierz, który cel kompilacji swojego projektu Unity chcesz zarejestrować, lub możesz nawet zarejestrować oba cele teraz w tym samym czasie.

  4. Wpisz identyfikatory platformy swojego projektu Unity.

    • Dla iOS - Wpisz projektu Unity iOS identyfikator w bundle ID iOS dziedzinie.

    • Dla Androida - Wpisz projektu Unity Android identyfikator w imię pakiet Android dziedzinie.
      Nazwa pakietu terminy i identyfikator aplikacji są często używane zamiennie.

  5. (Opcjonalnie) Wprowadź pseudonim danej platformy (a) projektu Unity.
    Te pseudonimy są wewnętrznymi, wygodnymi identyfikatorami i są widoczne tylko dla Ciebie w konsoli Firebase.

  6. Kliknij Register aplikację.

Krok 3: Dodawanie plików konfiguracyjnych Firebase

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

    • Dla iOS - kliknij Pobierz GoogleService-Info.plist.

    • Dla Androida - Kliknij przycisk Pobierz google-services.json.

  2. Otworzyć okno projektu projektu Unity, a następnie przenieść plik konfiguracyjny (y) w Assets folderu.

  3. Powrót w konsoli Firebase w obiegu instalacji, kliknij przycisk Dalej.

Krok 4: Dodaj Firebase Unity SDK

  1. W konsoli Firebase, kliknij Pobierz Firebase Unity SDK, a następnie rozpakuj SDK gdzieś wygodny.

    • Można pobrać Firebase Unity SDK ponownie w każdej chwili.

    • Pakiet Firebase Unity SDK nie jest specyficzny dla platformy.

  2. W swojej otwartego projektu Unity, przejdź do Pakietu Aktywów> Importuj> Pakiet Custom.

  3. Z rozpakowanym SDK wybierz obsługiwanych produktów Firebase które chcesz użyć w swojej aplikacji.

    Analiza włączona

    • Dodaj pakiet Firebase Google Analytics: FirebaseAnalytics.unitypackage
    • Dodaj pakiety dla innych produktów Firebase, których chcesz używać w swojej aplikacji. Na przykład, aby użyć Uwierzytelniania Firebase i Bazy danych czasu rzeczywistego Firebase:
      FirebaseAuth.unitypackage i FirebaseDatabase.unitypackage

    Analytics nie jest włączone

    Dodaj pakiety produktów Firebase, których chcesz używać w swojej aplikacji. Na przykład, aby użyć Uwierzytelniania Firebase i Bazy danych czasu rzeczywistego Firebase:
    FirebaseAuth.unitypackage i FirebaseDatabase.unitypackage

  4. W oknie importu Unity Package, kliknij przycisk Importuj.

  5. Powrót w konsoli Firebase w obiegu instalacji, kliknij przycisk Dalej.

Krok 5: Potwierdzenie wymagań wersja usługi Google Play

Firebase Unity SDK dla Androida wymaga usługi Google Play , które muszą być na bieżąco przed użyciem SDK.

Dodaj następujący kod na początku aplikacji. Możesz sprawdzić dostępność usług Google Play i opcjonalnie zaktualizować je do wersji wymaganej przez pakiet Firebase Unity SDK przed wywołaniem jakichkolwiek innych metod w pakiecie SDK.

Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWith(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 korzystania z Firebase.

Jeśli masz problemy z uzyskaniem konfiguracji, choć odwiedzić rozwiązywanie problemów Unity & FAQ .

Skonfiguruj obieg pulpitu (beta)

Kiedy tworzysz grę, często znacznie łatwiej jest najpierw przetestować ją w edytorze Unity i na platformach stacjonarnych, a następnie wdrożyć i przetestować na urządzeniach mobilnych w późniejszym etapie tworzenia. Aby wesprzeć ten przepływ pracy, zapewniamy podzbiór Firebase Unity SDK , który można uruchomić w systemie Windows, MacOS, Linux i od wewnątrz edytora Unity.

  1. Utworzenie platformy desktop projektu Unity, wykonując te same czynności, jak w przypadku platformy mobilnej (start z Rejestru swoją aplikację z Firebase kroku powyżej).

  2. Uruchom projekt Unity w jedności IDE lub wybierz budować swój projekt jedności dla pulpitu.

  3. (Opcjonalnie) Uruchom swój projekt Unity w trybie edycji.

    Pakiet Firebase Unity SDK można również uruchomić w trybie edycji Unity, co pozwala na używanie go w wtyczkach edytora.

    1. Podczas tworzenia FirebaseApp stosowane przez redaktora, nie używać instancji domyślnej.

    2. Zamiast zapewnić unikalną nazwę dla FirebaseApp.Create() rozmowy.

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

Obsługiwane produkty Firebase

Dowiedz się więcej o bibliotekach Unity Firebase w dokumentacji referencyjnej .

Firebase Unity SDK obsługuje następujące produkty Firebase na iOS i Androida:

Produkt Firebase Pakiet jedności
AdMob Dystrybucja oddzielnie we wtyczce AdMob Unity
Analityka FirebaseAnalytics.unitypackage
Uwierzytelnianie FirebaseAuth.unitypackage
Chmura Firestore (beta) FirebaseFirestore.unitypackage
Funkcje chmury FirebaseFunctions.unitypackage
Wiadomości w chmurze FirebaseMessaging.unitypackage
(zalecane) FirebaseAnalytics.unitypackage
Magazyn w chmurze FirebaseStorage.unitypackage
Crashlytics FirebaseCrashlytics.unitypackage
(zalecane) FirebaseAnalytics.unitypackage
Dynamiczne linki FirebaseDynamicLinks.unitypackage
(zalecane) FirebaseAnalytics.unitypackage
Baza danych czasu rzeczywistego FirebaseDatabase.unitypackage
Zdalna konfiguracja FirebaseRemoteConfig.unitypackage
(zalecane) FirebaseAnalytics.unitypackage

Obsługiwane produkty Firebase (komputery)

Firebase Unity SDK zawiera pulpitu wsparcie przepływu pracy dla podzbioru produktów, dzięki czemu pewne części Firebase być wykorzystane w edytorze Unity oraz w autonomicznym opiera się na pulpicie Windows, MacOS i Linux.

Produkt Firebase (komputer) Pakiet jedności
Uwierzytelnianie FirebaseAuth.unitypackage
Funkcje chmury FirebaseFunctions.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Magazyn w chmurze FirebaseStorage.unitypackage
Baza danych czasu rzeczywistego FirebaseDatabase.unitypackage
Zdalna konfiguracja FirebaseRemoteConfig.unitypackage

Firebase udostępnia pozostałe biblioteki dla komputerów stacjonarnych jako implementacje skrótowe (niefunkcjonalne) dla wygody podczas kompilowania dla systemów Windows, macOS i Linux. Dlatego nie musisz warunkowo kompilować kodu, aby kierować go na pulpit.

Następne kroki