Zwiększ skuteczność swoich gier w Unity dzięki pakietom SDK Firebase Unity.
Aby pokazać, jak łatwo można połączyć Firebase z projektem w Unity, przygotowaliśmy przykładową grę o nazwie MechaHamster. Jeśli chcesz wypróbować dodanie Firebase do gry, użyj wersji startowej dostępnej na GitHubie. Jeśli potrzebujesz ukończonej wersji, sprawdź znaleźć wersje w App Store lub Sklepie Google Play.
MechaHamster (sklep z aplikacjami)
Więcej informacji o zwiększaniu skuteczności gier dzięki Firebase znajdziesz w naszym Strona gier w Firebase
Masz już konto Firebase w projekcie w Unity? Upewnij się, że używasz tagu najnowszej wersji pakietu SDK Firebase Unity.
Wymagania wstępne
Zainstaluj Unity w wersji 2019.1 lub nowszej. Wcześniejsze wersje również mogą być zgodne, ale nie będą aktywnie obsługiwane. Podejmujemy decyzję o obsłudze Unity 2019.1 wycofane i nie będą aktywnie obsługiwane po następnej aktualizacji wersji.
(Tylko platformy Apple) Zainstaluj te elementy:
- Xcode 13.3.1 lub nowsza wersja
- CocoaPods w wersji 1.12.0 lub nowszej
Sprawdź, czy Twój projekt w Unity spełnia te wymagania:
- iOS – jest kierowana na system iOS 11 lub nowszy.
- tvOS – jest kierowana na system tvOS w wersji 12 lub nowszej
- Android – docelowy poziom interfejsu API 19 (KitKat) lub nowsza
Skonfiguruj urządzenie fizyczne lub użyj emulatora, aby uruchomić aplikację.
Platformy Apple – skonfiguruj urządzenie fizyczne albo użyj systemu iOS lub tvOS. symulatora.
Na urządzeniu z Androidem – Emulatory muszą używać funkcji z obrazem emulatora w Google Play.
- Zaloguj się w Firebase, korzystając ze swojego konta Google koncie.
Jeśli nie masz jeszcze projektu Unity i chcesz wypróbować Firebase, możesz pobrać nasze krótkie wprowadzenia.
Krok 1. Utwórz projekt Firebase
Zanim dodasz Firebase do projektu w Unity, musisz utworzyć który chcesz połączyć z projektem w Unity. Odwiedź Więcej informacji o projektach Firebase Projekty Firebase.
Krok 2. Zarejestruj aplikację w Firebase
Aby połączyć konto z Firebase, możesz zarejestrować co najmniej 1 aplikację lub grę w projektach AI.
Otwórz konsolę Firebase.
Na środku strony z opisem projektu kliknij ikonę Unity. (
) aby rozpocząć proces konfiguracji.Jeśli masz już aplikację w projekcie Firebase, kliknij Dodaj aplikację. aby wyświetlić opcje platformy.
Wybierz środowisko docelowe kompilacji projektu Unity, które chcesz zarejestrować lub zarejestrować oba cele jednocześnie.
Wpisz identyfikatory projektów Unity dla danej platformy.
iOS – w polu Pakiet na iOS Identyfikator .
Android – w polu Pakiet na Androida name.
Często używane są terminy nazwa pakietu i identyfikator aplikacji. zamiennie.
(Opcjonalnie) Wpisz pseudonimy związane z platformą projektu Unity.
Te pseudonimy to wewnętrzne, wygodne identyfikatory, które są widoczne tylko w konsoli Firebase.Kliknij Zarejestruj aplikację.
Krok 3. Dodaj pliki konfiguracji Firebase
Pliki konfiguracji Firebase dotyczące danej platformy znajdziesz w Proces konfiguracji konsoli Firebase.
iOS – kliknij Pobierz GoogleService-Info.plist.
Android – kliknij Pobierz google-services.json.
Otwórz okno Project (Projekt) w projekcie Unity, a następnie przenieś konfigurację pliki do folderu
Assets
.Gdy wrócisz do konsoli Firebase, w procesie konfiguracji kliknij Dalej.
Krok 4. Dodaj pakiety SDK Firebase Unity
W konsoli Firebase kliknij Pobierz pakiet SDK Firebase Unity i rozpakuj go. z pakietu SDK w dogodnym miejscu.
W każdej chwili możesz ponownie pobrać pakiet Firebase Unity SDK.
Pakiet SDK Firebase Unity nie jest związany z konkretną platformą.
W otwartym projekcie Unity przejdź do folderu Komponenty > Importuj pakiet > Pakiet niestandardowy.
W rozpakowanym pakiecie SDK wybierz obsługiwaną usługę Firebase usług, których chcesz używać do aplikacji.
Analityka włączona
- Dodaj pakiet Firebase dla Google Analytics:
FirebaseAnalytics.unitypackage
- Dodaj pakiety dla wszystkich innych usług Firebase, w których chcesz używać
do aplikacji. Aby np. skorzystać z Uwierzytelniania Firebase,
Baza danych czasu rzeczywistego Firebase:
FirebaseAuth.unitypackage
iFirebaseDatabase.unitypackage
Statystyki nie są włączone
Dodaj pakiety usług Firebase, których chcesz używać w swojej aplikacji. Aby na przykład użyć Uwierzytelniania Firebase i Bazy danych czasu rzeczywistego Firebase:
FirebaseAuth.unitypackage
iFirebaseDatabase.unitypackage
- Dodaj pakiet Firebase dla Google Analytics:
W oknie Import Unity Package (Importuj pakiet Unity) kliknij Import (Importuj).
Gdy wrócisz 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órych pakiet musi spełniać, że pakiet SDK musi być aktualny.
Dodaj instrukcję using
i kod inicjowania na początku
aplikacji. Możesz sprawdzić dostępność Usług Google Play i ewentualnie zaktualizować je do
wymaganej przez pakiet Firebase Unity SDK przed wywołaniem jakiegokolwiek innego
w pakiecie SDK.
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. Twój projekt w Unity jest zarejestrowany i skonfigurowany do używania Firebase.
Jeśli jednak masz problemy z konfiguracją, odwiedź Rozwiązywanie problemów z Unity Najczęstsze pytania.
Konfigurowanie przepływu pracy na komputerze (beta)
Gdy tworzysz grę, często łatwiej jest przetestować ją na stronie Najpierw w edytorze Unity i na platformach komputerowych, a potem wdróż i przetestuj na urządzeniach mobilnych. urządzeń w późniejszej fazie rozwoju. Aby ułatwić ten proces, udostępniamy podzbiór pakietów SDK Firebase Unity, które mogą działać w systemach Windows, macOS i Linux oraz w edytorze Unity.
Skonfiguruj projekt Unity na komputerze, postępując zgodnie z tymi samymi instrukcjami dla platformy mobilnej (zacznij od Zarejestruj aplikację w Firebase powyżej.
Uruchom projekt Unity w środowisku Unity IDE lub wybierz go, aby utworzyć Unity projekt na komputer.
(Opcjonalnie) Uruchom projekt Unity w trybie edycji.
Pakiet Firebase Unity SDK można też uruchomić w trybie edycji Unity, we wtyczce edytora.
Gdy tworzysz plik
FirebaseApp
używany przez edytor, nie używaj makra instancję domyślną.Zamiast tego nadaj wywołaniu
FirebaseApp.Create()
unikalną nazwę.Jest to ważne, aby uniknąć konfliktu opcji między używaną instancją przez IDE Unity i instancję używaną przez projekt Unity.
Obsługiwane usługi Firebase
Więcej informacji o bibliotekach Firebase w Unity znajdziesz w dokumentacji referencyjnej.
Dostępne biblioteki Firebase na urządzenia mobilne
Pakiet Firebase Unity SDK obsługuje następujące usługi Firebase w Apple i Android:
Usługa Firebase | Pakiet Unity |
---|---|
AdMob | Rozpowszechniane oddzielnie we wtyczce AdMob Unity |
Analytics | FirebaseAnalytics.unitypackage |
Sprawdzanie aplikacji | FirebaseAppCheck.unitypackage |
Uwierzytelnianie | FirebaseAuth.unitypackage |
Cloud Firestore | FirebaseFirestore.unitypackage |
Funkcje Cloud | FirebaseFunctions.unitypackage |
Komunikacja w chmurze | FirebaseMessaging.unitypackage (zalecane) FirebaseAnalytics.unitypackage |
Cloud Storage | 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 Firebase Unity SDK obejmuje obsługę przepływu pracy na komputerach dla podzbioru usług, dzięki czemu pewne części Firebase mogą być wykorzystywane w edytorze Unity i w samodzielnych kompilacjach na komputery z systemami Windows, macOS i Linux.
Usługa Firebase (komputery) | Pakiet Unity |
---|---|
Sprawdzanie aplikacji | FirebaseAppCheck.unitypackage |
Uwierzytelnianie | FirebaseAuth.unitypackage |
Funkcje Cloud | FirebaseFunctions.unitypackage |
Cloud Firestore | FirebaseFirestore.unitypackage |
Cloud Storage | FirebaseStorage.unitypackage |
Baza danych czasu rzeczywistego | FirebaseDatabase.unitypackage |
Zdalna konfiguracja | FirebaseRemoteConfig.unitypackage |
Firebase udostępnia pozostałe biblioteki komputerowe w postaci wersji atmosferycznej (niedziałającej) dla wygody użytkowników systemów Windows, macOS i Linux. Dzięki temu nie musisz warunkowo kompilować kodu kierowanego na komputer.
Dalsze kroki
Zobacz przykładowe aplikacje Firebase.
Przygotowanie do wprowadzenia aplikacji:
- Określ budżet alerty swojego projektu w konsoli Google Cloud.
- Monitorowanie korzystania i płatności panel w konsoli Firebase, aby uzyskać ogólny obraz i wielu usług Firebase.
- Zapoznaj się z listą kontrolną uruchamiania Firebase.
Masz problemy z Firebase i projektem Unity? Odwiedź stronę Rozwiązywanie problemów z Unity Najczęstsze pytania.