Dodaj Firebase do swojego projektu Unity
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 SDK Firebase Unity .
Warunki wstępne
Zainstaluj Unity 2018.4 lub nowszy. Wcześniejsze wersje mogą być również kompatybilne, 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 kolejnym wydaniu głównym.
(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 push w XCode w menu 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 i chcesz tylko wypróbować produkt Firebase, możesz pobrać jeden z naszych przykładów szybkiego startu .
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 wybrać, aby zarejestrować oba cele teraz w tym samym czasie.
Wpisz identyfikatory platformy swojego projektu Unity.
W przypadku 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) Wprowadź 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.
Analytics włączone
- Dodaj pakiet Firebase dla Google Analytics:
FirebaseAnalytics.unitypackage
- Dodaj pakiety dla wszelkich 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ć i opcjonalnie zaktualizować Usługi Google Play 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 w 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 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.
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 opcji 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 komputerowe 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 .