Wzmocnij swoje gry Unity dzięki naszym pakietom Firebase Unity SDK.
Aby pokazać, jak łatwo podłączyć Firebase do projektu Unity, stworzyliśmy przykładową grę MechaHamster, którą można pobrać z GitHub , App Store i Google Play Store .
Dowiedz się więcej o ulepszaniu swoich gier za pomocą Firebase na naszej stronie z grami w Firebase .
Dodałeś już Firebase do swojego projektu Unity? Upewnij się, że używasz najnowszej wersji pakietu Firebase Unity SDK .
Wymagania wstępne
Zainstaluj Unity 2019.1 lub nowszy. Wcześniejsze wersje mogą być również kompatybilne, ale nie będą aktywnie obsługiwane. Wsparcie dla Unity 2019.1 jest uważane za przestarzałe i nie będzie już aktywnie wspierane po następnej głównej wersji.
(Tylko platformy Apple) Zainstaluj następujące elementy:
- Xcode 13.3.1 lub nowszy
- CocoaPods 1.10.0 lub nowszy
Upewnij się, że Twój projekt Unity spełnia te wymagania:
- Dla iOS — celuje w system iOS 11 lub nowszy
- Dla systemu tvOS — jest przeznaczony dla systemu tvOS 12 lub nowszego
- Dla Androida — celuje w 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 lub użyj symulatora systemu iOS lub tvOS.
Oto wymagania wstępne dotyczące usługi Cloud Messaging w systemie iOS lub tvOS:
- Skonfiguruj urządzenie fizyczne .
- Uzyskaj klucz Apple Push Notification Authentication Key dla swojego konta programisty Apple .
- Włącz powiadomienia push w XCode w obszarze App > Capabilities .
Dla Androida — emulatory muszą używać obrazu emulatora z Google Play.
- Zaloguj się do Firebase przy użyciu swojego konta Google.
Jeśli nie masz jeszcze projektu Unity i chcesz tylko wypróbować produkt Firebase, możesz pobrać jedną z naszych próbek szybkiego startu .
Krok 1 : Utwórz projekt Firebase
Zanim będziesz mógł dodać Firebase do swojego projektu Unity, musisz utworzyć projekt Firebase, aby połączyć się z projektem Unity. Odwiedź stronę Projekty Firebase, aby dowiedzieć się więcej o projektach Firebase.
Krok 2 : Zarejestruj swoją aplikację w Firebase
Możesz zarejestrować jedną lub więcej aplikacji lub gier, aby połączyć się z projektem Firebase.
Przejdź do konsoli Firebase .
Na środku strony przeglądu projektu kliknij ikonę Unity (
), aby uruchomić proces konfiguracji.Jeśli już dodałeś aplikację do swojego projektu Firebase, kliknij Dodaj aplikację , aby wyświetlić opcje platformy.
Wybierz cel kompilacji swojego projektu Unity, który chcesz zarejestrować, lub możesz nawet zarejestrować oba cele jednocześnie.
Wprowadź identyfikatory specyficzne dla platformy projektu Unity.
Dla systemu iOS — wprowadź identyfikator iOS projektu Unity w polu Identyfikator pakietu iOS .
Dla systemu Android — wprowadź identyfikator systemu Android projektu Unity w polu nazwy pakietu systemu Android .
Terminy nazwa pakietu i identyfikator aplikacji są często używane zamiennie.
Otwórz swój projekt Unity w środowisku Unity IDE, a następnie przejdź do sekcji ustawień dla każdej platformy:
W systemie iOS — przejdź do opcji Ustawienia kompilacji > iOS .
Android — przejdź do Android > Ustawienia odtwarzacza > Inne ustawienia .
Identyfikator Twojego projektu Unity to wartość identyfikatora pakietu (przykładowy identyfikator:
com.yourcompany.yourproject
).(Opcjonalnie) Wprowadź pseudonimy związane z platformą projektu Unity.
Te pseudonimy to wewnętrzne, wygodne identyfikatory, które są widoczne tylko dla Ciebie w konsoli Firebase.Kliknij Zarejestruj aplikację .
Krok 3 : Dodaj pliki konfiguracyjne Firebase
Uzyskaj pliki konfiguracyjne Firebase specyficzne dla platformy w przepływie pracy konfiguracji konsoli Firebase.
W systemie iOS — kliknij opcję Pobierz GoogleService-Info.plist .
W systemie Android — kliknij Pobierz google-services.json .
Plik konfiguracyjny Firebase zawiera unikalne, ale nietajne identyfikatory Twojego projektu. Aby dowiedzieć się więcej o tym pliku konfiguracyjnym, odwiedź stronę Zrozumienie projektów Firebase .
W dowolnym momencie możesz ponownie pobrać plik konfiguracyjny Firebase .
Upewnij się, że nazwa pliku konfiguracyjnego nie zawiera dodatkowych znaków, takich jak
(2)
.
Otwórz okno projektu swojego projektu Unity, a następnie przenieś pliki konfiguracyjne do folderu
Assets
.Wróć do konsoli Firebase, w przepływie pracy instalacji kliknij Dalej .
Krok 4 : dodaj zestawy SDK Firebase Unity
W konsoli Firebase kliknij Pobierz pakiet SDK Firebase Unity , a następnie rozpakuj pakiet SDK w dogodnym miejscu.
W każdej chwili możesz ponownie pobrać pakiet Firebase Unity SDK .
Pakiet Firebase Unity SDK nie jest specyficzny dla platformy.
W otwartym projekcie Unity przejdź do pozycji Assets > Import Package > Custom Package .
Z rozpakowanego pakietu SDK wybierz obsługiwane produkty Firebase , których chcesz używać w swojej aplikacji.
Analityka włączona
- Dodaj pakiet Firebase dla 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
iFirebaseDatabase.unitypackage
Analityka nie jest włączona
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
iFirebaseDatabase.unitypackage
- Dodaj pakiet Firebase dla Google Analytics:
W oknie Importuj pakiet Unity kliknij przycisk Importuj .
Wróć do konsoli Firebase, w przepływie pracy instalacji kliknij Dalej .
Krok 5 : Potwierdź wymagania dotyczące wersji usług Google Play
Pakiet SDK Firebase Unity na Androida wymaga usług Google Play , które muszą być aktualne, zanim będzie można korzystać z pakietu SDK.
Dodaj następujący kod na początku swojej aplikacji. Możesz sprawdzić i opcjonalnie zaktualizować usługi Google Play do wersji wymaganej przez pakiet Firebase Unity SDK przed wywołaniem jakichkolwiek innych metod w zestawie 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 Unity jest zarejestrowany i skonfigurowany do korzystania z Firebase.
Jeśli jednak masz problemy z konfiguracją, odwiedź stronę Unity — rozwiązywanie problemów i często zadawane pytania .
Skonfiguruj przepływ pracy na komputerze ( wersja beta )
Podczas tworzenia gry często znacznie łatwiej jest najpierw przetestować grę w edytorze Unity i na platformach stacjonarnych, a następnie wdrożyć ją i przetestować na urządzeniach mobilnych w późniejszym okresie programowania. Aby wesprzeć ten przepływ pracy, udostępniamy podzbiór zestawów SDK Firebase Unity , które można uruchamiać w systemach Windows, macOS, Linux i z poziomu edytora Unity.
Skonfiguruj projekt Unity platformy komputerowej, postępując zgodnie z tymi samymi instrukcjami, co w przypadku platformy mobilnej (rozpocznij od kroku Zarejestruj swoją aplikację w Firebase powyżej).
Uruchom projekt Unity w środowisku Unity IDE lub wybierz, czy chcesz zbudować projekt Unity na komputery stacjonarne .
(Opcjonalnie) Uruchom projekt Unity w trybie edycji.
Zestaw SDK Firebase Unity można również uruchomić w trybie edycji Unity, co pozwala na jego użycie we wtyczkach edytora.
Podczas tworzenia aplikacji
FirebaseApp
używanej przez edytor nie używaj instancji domyślnej.Zamiast tego podaj unikalną nazwę wywołania
FirebaseApp.Create()
.Jest to ważne, aby uniknąć konfliktu opcji między instancją używaną przez Unity IDE a instancją używaną przez twój projekt Unity.
Obsługiwane produkty Firebase
Dowiedz się więcej o bibliotekach Unity Firebase w dokumentacji referencyjnej .
Dostępne biblioteki Firebase dla urządzeń mobilnych
Pakiet Firebase Unity SDK obsługuje następujące produkty Firebase na Apple i Androida :
Produkt Firebase | Pakiet jedności |
---|---|
AdMob | Dystrybuowane oddzielnie we wtyczce AdMob Unity |
Analityka | FirebaseAnalytics.unitypackage |
Sprawdź aplikację | FirebaseAppCheck.unitypackage |
Uwierzytelnianie | FirebaseAuth.unitypackage |
Cloud Firestore | 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 |
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 SDK Firebase Unity obejmuje obsługę przepływów pracy na komputerach stacjonarnych dla podzbioru produktów, umożliwiając korzystanie z niektórych części Firebase w edytorze Unity oraz w samodzielnych kompilacjach komputerów stacjonarnych w systemach Windows, macOS i Linux.
Produkt Firebase (komputer stacjonarny) | Pakiet jedności |
---|---|
Sprawdź aplikację | FirebaseAppCheck.unitypackage |
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 zapewnia pozostałe biblioteki komputerowe jako implementacje pośredniczące (niefunkcjonalne) dla wygody podczas tworzenia dla systemów Windows, macOS i Linux. W związku z tym nie trzeba warunkowo kompilować kodu w celu kierowania na pulpit.
Następne kroki
Poznaj przykładowe aplikacje Firebase .
Przygotuj się do uruchomienia aplikacji:
- Skonfiguruj alerty budżetowe dla swojego projektu w Google Cloud Console.
- Monitoruj pulpit nawigacyjny Wykorzystanie i rozliczenia w konsoli Firebase, aby uzyskać ogólny obraz wykorzystania projektu w wielu usługach Firebase.
- Przejrzyj listę kontrolną uruchamiania Firebase .
Masz problem z Firebase i projektem Unity? Odwiedź stronę Rozwiązywanie problemów i często zadawane pytania dotyczące aparatu Unity .