Wzmocnij swoje gry 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 wypróbować dodanie Firebase do gry, użyj wersji startowej dostępnej w GitHub . Jeśli chcesz pełną wersję, sprawdź wersje w App Store lub sklepie Google Play .
MechaHamster (sklep z aplikacjami)
Więcej informacji o zasilaniu gier za pomocą Firebase znajdziesz na naszej stronie gier Firebase .
Dodałeś już Firebase do swojego projektu Unity? Upewnij się, że używasz najnowszej wersji pakietu Firebase Unity SDK .
Warunki wstępne
Zainstaluj Unity 2019.1 lub nowszą. Wcześniejsze wersje mogą również być 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 wydaniu 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 następujące wymagania:
- Dla systemu iOS — przeznaczony dla systemu iOS 11 lub nowszego
- Dla systemu tvOS — przeznaczony dla systemu tvOS 12 lub nowszego
- Dla Androida — docelowy poziom API 19 (KitKat) lub wyższy
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.
Oto wymagania wstępne dotyczące usługi Cloud Messaging w systemie iOS lub tvOS:
- Skonfiguruj urządzenie fizyczne .
- Uzyskaj klucz uwierzytelniający powiadomienia Apple Push dla swojego konta programisty Apple .
- Włącz powiadomienia push w XCode w obszarze Aplikacja > Możliwości .
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 po prostu wypróbować produkt Firebase, możesz pobrać jeden z naszych przykładów 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ę Poznaj 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ć przepływ pracy instalacji.Jeśli dodałeś już aplikację do projektu Firebase, kliknij Dodaj aplikację , aby wyświetlić opcje platformy.
Wybierz, który cel kompilacji swojego projektu Unity chcesz zarejestrować, lub możesz nawet zarejestrować oba cele jednocześnie.
Wprowadź identyfikatory specyficzne dla platformy projektu Unity.
W przypadku 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 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 .
W systemie Android — wybierz opcję Android > Ustawienia odtwarzacza > Inne ustawienia .
Identyfikator Twojego projektu Unity to wartość identyfikatora pakietu (przykładowy identyfikator:
com.yourcompany.yourproject
).(Opcjonalnie) Wprowadź pseudonimy specyficzne dla platformy projektu Unity.
Te pseudonimy są wewnętrznymi, wygodnymi identyfikatorami i są widoczne tylko dla Ciebie w konsoli Firebase.Kliknij opcję Zarejestruj aplikację .
Krok 3 : Dodaj pliki konfiguracyjne Firebase
Uzyskaj pliki konfiguracyjne Firebase specyficzne dla platformy w procesie konfiguracji konsoli Firebase.
W systemie iOS — kliknij Pobierz plik GoogleService-Info.plist .
W systemie Android — kliknij Pobierz plik google-services.json .
Plik konfiguracyjny Firebase zawiera unikalne, ale nie tajne identyfikatory Twojego projektu. Aby dowiedzieć się więcej o tym pliku konfiguracyjnym, odwiedź stronę Informacje o projektach Firebase .
W dowolnym momencie możesz ponownie pobrać plik konfiguracyjny Firebase .
Upewnij się, że nazwa pliku konfiguracyjnego nie jest uzupełniona dodatkowymi znakami, takimi jak
(2)
.
Otwórz okno Projekt swojego projektu Unity, a następnie przenieś pliki konfiguracyjne do folderu
Assets
.W konsoli Firebase, w procesie konfiguracji, kliknij Dalej .
Krok 4 : Dodaj pakiety SDK Firebase Unity
W konsoli Firebase kliknij Pobierz pakiet SDK Firebase Unity , a następnie rozpakuj pakiet SDK w dogodnym miejscu.
W dowolnej chwili możesz ponownie pobrać pakiet SDK Firebase Unity .
Zestaw SDK Firebase Unity nie jest specyficzny dla platformy.
W otwartym projekcie Unity przejdź do opcji Zasoby > Importuj pakiet > Pakiet niestandardowy .
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 Firebase Realtime:
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 Firebase Realtime:
FirebaseAuth.unitypackage
iFirebaseDatabase.unitypackage
- Dodaj pakiet Firebase dla Google Analytics:
W oknie Importuj pakiet Unity kliknij opcję Importuj .
W konsoli Firebase, w procesie konfiguracji, kliknij Dalej .
Krok 5 : Potwierdź wymagania dotyczące wersji usług Google Play
Zestaw SDK Firebase Unity dla Androida wymaga usług Google Play , które muszą być aktualne, aby móc korzystać z zestawu SDK.
Dodaj następujący kod na początku aplikacji. Możesz sprawdzić i opcjonalnie zaktualizować Usługi Google Play do wersji wymaganej przez zestaw SDK Firebase Unity 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ę Rozwiązywanie problemów i często zadawane pytania dotyczące Unity .
Skonfiguruj przepływ pracy na komputerze stacjonarnym ( 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, udostępniamy podzbiór pakietów SDK Firebase Unity , które można uruchomić w systemach Windows, macOS, Linux oraz w edytorze Unity.
Skonfiguruj projekt Unity na platformie komputerowej, postępując zgodnie z tymi samymi instrukcjami, co w przypadku platformy mobilnej (rozpocznij od kroku Zarejestruj aplikację w Firebase powyżej).
Uruchom projekt Unity w środowisku Unity IDE lub wybierz opcję zbudowania projektu Unity na komputer stacjonarny .
(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.
Tworząc
FirebaseApp
używaną przez edytor, nie używaj instancji domyślnej.Zamiast tego podaj unikalną nazwę wywołaniu
FirebaseApp.Create()
.Jest to ważne, aby uniknąć konfliktu opcji między instancją używaną przez środowisko Unity IDE a instancją używaną przez 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
Zestaw SDK Firebase Unity obsługuje następujące produkty Firebase na urządzeniach Apple i Android :
Produkt Firebase | Pakiet jedności |
---|---|
AdMob | Dystrybuowane oddzielnie we wtyczce AdMob Unity |
Analityka | FirebaseAnalytics.unitypackage |
Kontrola aplikacji | FirebaseAppCheck.unitypackage |
Uwierzytelnianie | FirebaseAuth.unitypackage |
Chmura 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 stacjonarne
Pakiet Firebase Unity SDK obejmuje obsługę przepływu pracy na komputerach stacjonarnych dla podzbioru produktów, umożliwiając używanie 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 |
---|---|
Kontrola aplikacji | FirebaseAppCheck.unitypackage |
Uwierzytelnianie | FirebaseAuth.unitypackage |
Funkcje chmury | FirebaseFunctions.unitypackage |
Chmura Firestore | FirebaseFirestore.unitypackage |
Magazyn w chmurze | FirebaseStorage.unitypackage |
Baza danych czasu rzeczywistego | FirebaseDatabase.unitypackage |
Zdalna konfiguracja | FirebaseRemoteConfig.unitypackage |
Firebase udostępnia 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 przeznaczonego na komputer stacjonarny.
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 panel użytkowania i rozliczeń w konsoli Firebase, aby uzyskać ogólny obraz wykorzystania projektu w wielu usługach Firebase.
- Przejrzyj listę kontrolną uruchamiania Firebase .
Masz problemy z Firebase i projektem Unity? Odwiedź stronę dotyczącą rozwiązywania problemów i często zadawanych pytań dotyczących Unity .