Wzmocnij swoje gry Unity dzięki naszym pakietom SDK Firebase Unity.
Aby pokazać, jak łatwo można podłączyć Firebase do projektu Unity, przygotowaliśmy przykładową grę MechaHamster, którą można pobrać z GitHub , App Store i Google Play Store .
MechaHamster (sklep z aplikacjami)
Więcej informacji na temat zwiększania mocy 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 2018.4 lub nowszy. Wcześniejsze wersje mogą być również zgodne, ale nie będą aktywnie wspierane. Wsparcie dla Unity 2018.4 jest uważane za przestarzałe i nie będzie już aktywnie wspierane po kolejnej wersji głównej.
(tylko iOS) 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 — przeznaczony dla iOS 10 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 systemu iOS — skonfiguruj fizyczne urządzenie z systemem iOS lub użyj symulatora systemu iOS.
W przypadku Cloud Messaging na iOS, oto wymagania wstępne:
- Skonfiguruj fizyczne urządzenie z systemem iOS .
- Uzyskaj klucz uwierzytelniania Apple Push Notification dla swojego konta Apple Developer .
- Włącz powiadomienia wypychane w XCode w obszarze App > Capabilities .
W przypadku systemu Android — emulatory muszą używać obrazu emulatora w Google Play.
- Zaloguj się do Firebase przy użyciu swojego konta Google.
Jeśli nie masz jeszcze projektu Unity, a chcesz tylko wypróbować produkt Firebase, możesz pobrać jeden z naszych krótkich przykładów .
Krok 1 : utwórz projekt Firebase
Zanim dodasz Firebase do projektu Unity, musisz utworzyć projekt Firebase, aby połączyć się z projektem Unity. Odwiedź Zrozumienie projektów Firebase , aby dowiedzieć się więcej o projektach Firebase.
Krok 2 : Zarejestruj swoją aplikację w Firebase
Możesz zarejestrować co najmniej jedną aplikację lub grę, 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 teraz w tym samym czasie.
Wpisz identyfikatory platformy swojego projektu Unity.
W przypadku systemu iOS — wprowadź identyfikator iOS projektu Unity w polu identyfikator pakietu iOS .
W przypadku systemu Android — wprowadź identyfikator Androida projektu Unity w polu nazwy pakietu Android .
Terminy nazwa pakietu i identyfikator aplikacji są często używane zamiennie.
Otwórz projekt Unity w swoim Unity IDE, a następnie przejdź do sekcji ustawień dla każdej platformy:
W przypadku systemu iOS — przejdź do opcji Ustawienia kompilacji > iOS .
W przypadku systemu Android — przejdź do opcji Android > Ustawienia odtwarzacza > Inne ustawienia .
Identyfikator projektu Unity to wartość identyfikatora pakietu (przykładowy identyfikator:
com.yourcompany.yourproject
).(Opcjonalnie) Wpisz pseudonimy związane z platformą projektu Unity.
Te pseudonimy są wewnętrznymi, wygodnymi identyfikatorami i są widoczne tylko dla Ciebie w konsoli Firebase.Kliknij Zarejestruj aplikację .
Krok 3 : Dodaj pliki konfiguracyjne Firebase
Uzyskaj pliki konfiguracyjne Firebase dla konkretnej platformy w procesie konfiguracji konsoli Firebase.
W przypadku systemu iOS — kliknij Pobierz GoogleService-Info.plist .
W przypadku systemu Android — kliknij Pobierz 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ę 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 procesie konfiguracji kliknij Dalej .
Krok 4. Dodaj pakiety SDK Firebase Unity
W konsoli Firebase kliknij Pobierz pakiet Firebase Unity SDK , a następnie rozpakuj pakiet SDK w dogodnym miejscu.
W dowolnym momencie możesz ponownie pobrać pakiet Firebase Unity SDK .
Pakiet Firebase Unity SDK nie jest specyficzny dla platformy.
W otwartym projekcie Unity przejdź do Zasoby > Importuj pakiet > Pakiet niestandardowy .
Z rozpakowanego pakietu SDK wybierz obsługiwane produkty Firebase , których chcesz używać w swojej aplikacji.
Analiza 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
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
iFirebaseDatabase.unitypackage
- Dodaj pakiet Firebase dla Google Analytics:
W oknie Importuj pakiet Unity kliknij opcję Importuj .
Wróć do konsoli Firebase, w procesie konfiguracji kliknij Dalej .
Krok 5 : Potwierdź wymagania dotyczące wersji usług Google Play
Pakiet Firebase Unity SDK na Androida wymaga usług Google Play , które muszą być aktualne, aby można było z niego korzystać.
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 jednak masz problemy z konfiguracją, odwiedź sekcję Rozwiązywanie problemów i często zadawane pytania dotyczące Unity .
Skonfiguruj przepływ pracy na komputerze ( 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 na późniejszym etapie tworzenia. 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 oraz w edytorze Unity.
Skonfiguruj projekt Unity na komputery stacjonarne, wykonując te same instrukcje, co w przypadku platformy mobilnej (zacznij od kroku Zarejestruj swoją aplikację w Firebase powyżej).
Uruchom swój projekt Unity w Unity IDE lub wybierz skompilowanie projektu Unity dla komputerów stacjonarnych .
(Opcjonalnie) Uruchom 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.
Tworząc aplikację
FirebaseApp
używaną przez edytor, nie używaj instancji domyślnej.Zamiast tego podaj unikatową nazwę wywołaniu
FirebaseApp.Create()
.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 .
Pakiet Firebase Unity SDK obsługuje następujące produkty Firebase w systemach iOS i Android :
Produkt Firebase | Pakiet jedności |
---|---|
AdMob | Dystrybucja oddzielnie we wtyczce AdMob Unity |
Analityka | FirebaseAnalytics.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 |
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)
Pakiet Firebase Unity SDK obejmuje obsługę przepływów pracy na pulpicie dla podzbioru produktów, umożliwiając korzystanie z niektórych części Firebase w edytorze Unity oraz w samodzielnych kompilacjach pulpitu w systemach 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
Poznaj przykładowe aplikacje Firebase .
Przygotuj się do uruchomienia aplikacji:
- Skonfiguruj alerty budżetowe dla swojego projektu w Google Cloud Console.
- Monitoruj panel użycia i rozliczeń 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ź sekcję rozwiązywania problemów i często zadawane pytania dotyczące Unity .