Zwiększ możliwości gier Unity dzięki pakietom SDK Firebase Unity.
Aby pokazać, jak łatwo można 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 na GitHubie. Jeśli chcesz mieć gotową wersję, sprawdź wersje w App Store lub Google Play Store.
Więcej informacji o zwiększaniu skuteczności gier dzięki Firebase znajdziesz w naszym Strona gier w Firebase
Czy Firebase zostało już dodane do projektu Unity? Upewnij się, że używasz najnowszej wersji pakietu SDK Firebase Unity.
Wymagania wstępne
Zainstaluj Unity LTS 2021 lub nowszą wersję. Weźmiemy pod uwagę obsługę Unity 2020 wycofane i nie będą aktywnie obsługiwane po wersji. Wcześniejsze wersje mogą być zgodne, ale nie będą aktywnie obsługiwane.
(Dotyczy tylko platform Apple) Zainstaluj te elementy:
- Xcode w wersji 13.3.1 lub nowszej
- CocoaPods w wersji 1.12.0 lub nowszej
Sprawdź, czy Twój projekt w Unity spełnia te wymagania:
- Na urządzeniach z iOS – wersja na iOS 13 lub nowszy
- W przypadku tvOS: docelowy tvOS 13 lub nowszy.
- Na Androida – kieruj aplikację na poziom API 21 (Lollipop) lub wyższy.
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.
Android – emulatory muszą używać obrazu z Google Play.
- Zaloguj się w Firebase, korzystając ze swojego konta Google koncie.
Jeśli nie masz jeszcze projektu Unity, ale chcesz wypróbować produkt Firebase, możesz pobrać jeden z naszych próbnych przykładów kodu.
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 cel kompilacji projektu Unity, który chcesz zarejestrować, lub wybierz opcję rejestracji obu celów jednocześnie.
Wpisz identyfikatory platformy swojego projektu Unity.
iOS – w polu Pakiet na iOS Identyfikator .
W przypadku Androida: w polu Nazwa pakietu Androida wpisz identyfikator Androida swojego projektu Unity.
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
Pobierz pliki konfiguracji Firebase dla poszczególnych platform w procesie konfiguracji konsoli Firebase.
iOS – kliknij Pobierz GoogleService-Info.plist.
Android – kliknij Pobierz google-services.json.
Otwórz okno Projekt w projekcie Unity, a potem przenieś pliki konfiguracji do folderu
Assets
.Wróć do konsoli Firebase i w procesie konfiguracji kliknij Dalej.
Krok 4. Dodaj pakiety SDK Firebase Unity
W konsoli Firebase kliknij Pobierz pakiet Firebase SDK Unity, a następnie rozpakuj go. z pakietu SDK w dogodnym miejscu.
W dowolnym momencie możesz ponownie pobrać pakiet SDK Firebase Unity.
Pakiet SDK Firebase Unity nie jest związany z konkretną platformą.
W otwartym projekcie Unity kliknij Zasoby > Importuj pakiet > Pakiet niestandardowy.
W rozpakowanym pakiecie SDK wybierz obsługiwane usługi Firebase, których chcesz używać w aplikacji.
Włączono: Analytics
- Dodaj pakiet Firebase dla konta Google Analytics:
FirebaseAnalytics.unitypackage
- Dodaj pakiety dla wszystkich innych usług Firebase, w których chcesz używać
do aplikacji. Aby na przykład użyć atrybutów Firebase Authentication i
Firebase Realtime Database:
FirebaseAuth.unitypackage
iFirebaseDatabase.unitypackage
Analytics nie jest włączona
Dodaj pakiety usług Firebase, których chcesz używać w aplikacji. Na przykład, aby użyć usług Firebase Authentication i Firebase Realtime Database:
FirebaseAuth.unitypackage
iFirebaseDatabase.unitypackage
- Dodaj pakiet Firebase dla konta Google Analytics:
W oknie Import Unity Package (Importuj pakiet Unity) kliknij Import (Importuj).
W procesie konfiguracji ponownie w konsoli Firebase kliknij Dalej.
Krok 5. Sprawdź wymagania dotyczące wersji Usług Google Play
Pakiet SDK Firebase Unity na Androida wymaga pakietu Google Play services, który musi być zaktualizowany, zanim będzie można używać pakietu SDK.
Dodaj instrukcję using
i kod inicjowania na początku
aplikacji. Możesz sprawdzić i opcjonalnie zaktualizować Google Play services do
wersji wymaganej przez pakiet SDK Firebase Unity 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ą, zapoznaj się z artykułem Rozwiązywanie problemów z Unity i najczęstsze pytania.
Konfigurowanie przepływu pracy na komputerze (beta)
Podczas tworzenia gry często łatwiej jest ją najpierw przetestować w edytorze Unity i na platformach komputerowych, a potem wdrożyć i przetestować na urządzeniach mobilnych. Aby ułatwić ten proces, udostępniamy podzbiór pakietów SDK Firebase Unity, które mogą być uruchamiane w systemach Windows, macOS i Linux oraz w edytorze Unity.
Skonfiguruj projekt Unity na platformę komputerową, wykonując te same instrukcje, co w przypadku platformy mobilnej (zacznij od kroku Zarejestruj aplikację w Firebase).
Uruchom projekt Unity w IDE Unity lub wybierz kompilację projektu Unity na komputer.
(Opcjonalnie) Uruchom projekt Unity w trybie edycji.
Pakiet SDK Firebase Unity można też uruchomić w trybie edycji Unity, co pozwala na użycie: we wtyczce edytora.
Podczas tworzenia
FirebaseApp
używanego przez edytor nie używaj instancji domyślnej.Zamiast tego nadaj wywołaniu
FirebaseApp.Create()
niepowtarzalną nazwę.Jest to ważne, aby uniknąć konfliktu opcji między instancją używaną przez IDE Unity a 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 SDK Firebase Unity obsługuje te usługi Firebase na platformach Apple i Android:
Usługa Firebase | Pakiet Unity |
---|---|
AdMob | rozpowszechniane osobno w ramach wtyczki AdMob Unity; |
Analytics | FirebaseAnalytics.unitypackage |
App Check | FirebaseAppCheck.unitypackage |
Authentication | FirebaseAuth.unitypackage |
Cloud Firestore | FirebaseFirestore.unitypackage |
Cloud Functions | FirebaseFunctions.unitypackage |
Cloud Messaging | FirebaseMessaging.unitypackage (zalecane) FirebaseAnalytics.unitypackage |
Cloud Storage | FirebaseStorage.unitypackage |
Crashlytics | FirebaseCrashlytics.unitypackage (zalecane) FirebaseAnalytics.unitypackage |
Dynamic Links | FirebaseDynamicLinks.unitypackage (zalecane) FirebaseAnalytics.unitypackage |
Realtime Database | FirebaseDatabase.unitypackage |
Remote Config | FirebaseRemoteConfig.unitypackage (zalecane) FirebaseAnalytics.unitypackage |
Dostępne biblioteki Firebase na komputery
Pakiet SDK Firebase Unity zawiera obsługę procesów na komputerze w przypadku podzbioru usług, co umożliwia korzystanie z pewnych części Firebase w edytorze Unity oraz w samodzielnych wersjach na komputery z systemem Windows, macOS i Linux.
Usługa Firebase (komputery) | Pakiet Unity |
---|---|
App Check | FirebaseAppCheck.unitypackage |
Authentication | FirebaseAuth.unitypackage |
Cloud Functions | FirebaseFunctions.unitypackage |
Cloud Firestore | FirebaseFirestore.unitypackage |
Cloud Storage | FirebaseStorage.unitypackage |
Realtime Database | FirebaseDatabase.unitypackage |
Remote Config | FirebaseRemoteConfig.unitypackage |
Firebase udostępnia pozostałe biblioteki na komputery jako implementacje w postaci stubów (niefunkcjonalnych) dla wygody podczas kompilowania aplikacji na Windowsa, macOS i Linuxa. Dzięki temu nie musisz warunkowo kompilować kodu kierowanego na komputer.
Dalsze kroki
Zobacz przykładowe aplikacje Firebase.
Przygotowanie do wprowadzenia aplikacji:
- W konsoli Google Cloud skonfiguruj alerty dotyczące budżetu dla projektu.
- Aby uzyskać ogólny obraz wykorzystania projektu w różnych usługach Firebase, monitoruj panel Dane i rozliczenia w konsoli 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.