Dodaj Firebase do projektu Unity bookmark_border Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

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 jest już dodany do Twojego projektu w 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 – kierowana na interfejs API na poziomie 23 (Marshmallow) 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.

    Czy chcesz użyć 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 na koncie dewelopera Apple.
    • Włącz powiadomienia push w XCode w sekcji App > Capabilities (Aplikacja > Funkcje).

  • W przypadku Androida – emulatory muszą używać obrazu emulatora z Google Play.

• Zaloguj się w Firebase, używając konta Google.

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 (plat_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.

   Gdzie znajdę identyfikator projektu Unity?

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

   • iOS – kliknij Ustawienia kompilacji > iOS.

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

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

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 poszczególnych platform w ramach Firebaseprocesu konfiguracji konsoli.

   • iOS – kliknij Pobierz GoogleService-Info.plist.

   • Android – kliknij Pobierz google-services.json.

   Co musisz wiedzieć o tym pliku konfiguracyjnym?

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

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

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

2. Otwórz okno Project(Projekt) 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 Nie włączono Analytics Więcej

   • 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

   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ć, czy Google Play services jest w wymaganej wersji, i w razie potrzeby zaktualizować ją do tej 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 (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 można uruchamiać 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:

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.

Firebase udostępnia pozostałe biblioteki na komputery w postaci implementacji typu stub (niefunkcjonalnych), aby ułatwić tworzenie aplikacji na Windows, macOS i Linux. Dlatego nie musisz warunkowo kompilować kodu, aby kierować go na komputery.

Dalsze kroki

• Przejrzyj przykładowe aplikacje Firebase.

• Przygotuj się do uruchomienia aplikacji:

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

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