Firebase Unity SDK'larımızla Unity oyunlarınızı güçlendirin.
Firebase'i Unity projenize bağlamanın ne kadar kolay olduğunu göstermek için MechaHamster adında örnek bir oyun hazırladık. Firebase'i bir oyuna eklemeyi denemek istiyorsanız GitHub'daki başlangıç sürümünü kullanın. Tamamlanmış bir sürüm istiyorsanız App Store veya Google Play Store'daki sürümlere göz atın.
MechaHamster (Uygulama Mağazası)
Firebase oyunları sayfamızdan oyunlarınızı Firebase ile güçlendirme hakkında daha fazla bilgi edinin.
Firebase'i Unity projenize zaten eklediniz mi? Firebase Unity SDK'nın en son sürümünü kullandığınızdan emin olun.
Önkoşullar
Unity 2019.1 veya üstünü yükleyin. Daha önceki sürümler de uyumlu olabilir ancak aktif olarak desteklenmeyecektir. Unity 2019.1 desteğinin kullanımdan kaldırıldığı kabul ediliyor ve bir sonraki büyük sürümden sonra artık aktif olarak desteklenmeyecek.
(Yalnızca Apple platformları) Aşağıdakileri yükleyin:
- Xcode 13.3.1 veya üzeri
- CocoaPod'lar 1.10.0 veya üzeri
Unity projenizin şu gereksinimleri karşıladığından emin olun:
- iOS için — iOS 11 veya üstünü hedefler
- tvOS için - tvOS 12 veya üstünü hedefler
- Android için — API düzeyi 19 (KitKat) veya üstünü hedefler
Uygulamanızı çalıştırmak için fiziksel bir cihaz kurun veya bir emülatör kullanın.
Apple platformları için — Fiziksel bir cihaz kurun veya bir iOS ya da tvOS simülatörü kullanın.
iOS veya tvOS'te Bulut Mesajlaşma için önkoşullar şunlardır:
- Fiziksel bir cihaz kurun.
- Apple Geliştirici hesabınız için bir Apple Anında Bildirim Kimlik Doğrulama Anahtarı edinin.
- Uygulama > Yetenekler altında XCode'da Anında Bildirimleri etkinleştirin.
Android için — Emülatörlerin Google Play'de bir emülatör resmi kullanması gerekir.
- Google hesabınızı kullanarak Firebase'de oturum açın .
Henüz bir Unity projeniz yoksa ve yalnızca bir Firebase ürününü denemek istiyorsanız hızlı başlangıç örneklerimizden birini indirebilirsiniz.
1. Adım : Firebase projesi oluşturun
Firebase'i Unity projenize ekleyebilmeniz için öncelikle Unity projenize bağlanacak bir Firebase projesi oluşturmanız gerekir. Firebase projeleri hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlayın sayfasını ziyaret edin.
2. Adım : Uygulamanızı Firebase'e kaydedin
Firebase projenize bağlanmak için bir veya daha fazla uygulama veya oyunu kaydedebilirsiniz.
Firebase konsoluna gidin.
Kurulum iş akışını başlatmak için projeye genel bakış sayfasının ortasında Unity simgesine (
) tıklayın.Firebase projenize zaten bir uygulama eklediyseniz platform seçeneklerini görüntülemek için Uygulama ekle'yi tıklayın.
Unity projenizin hangi yapı hedefini kaydetmek istediğinizi seçin, hatta her iki hedefi de aynı anda kaydetmeyi bile seçebilirsiniz.
Unity projenizin platforma özel kimlik(ler)ini girin.
iOS için — iOS paket kimliği alanına Unity projenizin iOS kimliğini girin.
Android için — Unity projenizin Android kimliğini Android paket adı alanına girin.
Paket adı ve uygulama kimliği terimleri sıklıkla birbirinin yerine kullanılır.
Unity projenizi Unity IDE'nizde açın, ardından her platformun ayarlar bölümüne gidin:
iOS için — Yapı Ayarları > iOS'a gidin.
Android için — Android > Oynatıcı Ayarları > Diğer Ayarlar'a gidin.
Unity projenizin kimliği Paket Tanımlayıcı değeridir (örnek kimlik:
com.yourcompany.yourproject
).(İsteğe bağlı) Unity projenizin platforma özel takma adlarını girin.
Bu takma adlar dahili, kullanışlı tanımlayıcılardır ve yalnızca Firebase konsolunda sizin tarafınızdan görülebilir.Uygulamayı kaydet'i tıklayın.
3. Adım : Firebase yapılandırma dosyalarını ekleyin
Platforma özel Firebase yapılandırma dosyalarınızı Firebase konsolu kurulum iş akışında edinin.
iOS için — GoogleService-Info.plist'i İndir'i tıklayın.
Android için — Google-services.json'u İndir'i tıklayın.
Firebase yapılandırma dosyası, projeniz için benzersiz ancak gizli olmayan tanımlayıcılar içerir. Bu yapılandırma dosyası hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlayın sayfasını ziyaret edin.
Firebase yapılandırma dosyanızı istediğiniz zaman tekrar indirebilirsiniz.
Yapılandırma dosyası adına
(2)
gibi ek karakterler eklenmediğinden emin olun.
Unity projenizin Proje penceresini açın, ardından yapılandırma dosyalarınızı
Assets
klasörüne taşıyın.Firebase konsoluna geri döndüğünüzde, kurulum iş akışında İleri'yi tıklayın.
4. Adım : Firebase Unity SDK'larını ekleyin
Firebase konsolunda Firebase Unity SDK'yı İndir seçeneğine tıklayın ve ardından SDK'yı uygun bir yerde açın.
Firebase Unity SDK'yı istediğiniz zaman tekrar indirebilirsiniz.
Firebase Unity SDK platforma özel değildir.
Açık Unity projenizde Varlıklar > Paketi İçe Aktar > Özel Paket'e gidin.
Sıkıştırılmış SDK'dan uygulamanızda kullanmak istediğiniz desteklenen Firebase ürünlerini seçin.
Analiz etkin
- Google Analytics için Firebase paketini ekleyin:
FirebaseAnalytics.unitypackage
- Uygulamanızda kullanmak istediğiniz diğer Firebase ürünlerinin paketlerini ekleyin. Örneğin, Firebase Authentication ve Firebase Realtime Database'i kullanmak için:
FirebaseAuth.unitypackage
veFirebaseDatabase.unitypackage
Analiz etkinleştirilmedi
Uygulamanızda kullanmak istediğiniz Firebase ürünlerine ait paketleri ekleyin. Örneğin, Firebase Authentication ve Firebase Realtime Database'i kullanmak için:
FirebaseAuth.unitypackage
veFirebaseDatabase.unitypackage
- Google Analytics için Firebase paketini ekleyin:
Unity Paketini İçe Aktar penceresinde İçe Aktar öğesine tıklayın.
Firebase konsoluna geri döndüğünüzde, kurulum iş akışında İleri'yi tıklayın.
5. Adım : Google Play hizmetlerinin sürüm gereksinimlerini onaylayın
Android için Firebase Unity SDK'sı, SDK'nın kullanılabilmesi için güncel olması gereken Google Play hizmetlerini gerektirir.
Uygulamanızın başına aşağıdaki kodu ekleyin. SDK'daki diğer yöntemleri çağırmadan önce Google Play hizmetlerini kontrol edebilir ve isteğe bağlı olarak Firebase Unity SDK'nın gerektirdiği sürüme güncelleyebilirsiniz.
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. } });
Hazırsınız! Unity projeniz Firebase'i kullanacak şekilde kaydedildi ve yapılandırıldı.
Kurulum konusunda sorun yaşıyorsanız Unity sorunlarını giderme ve SSS sayfasını ziyaret edin.
Masaüstü iş akışı ayarlama ( beta )
Bir oyun oluşturduğunuzda, oyununuzu önce Unity editöründe ve masaüstü platformlarında test etmek, ardından geliştirme aşamasında mobil cihazlara dağıtmak ve test etmek genellikle çok daha kolaydır. Bu iş akışını desteklemek için Windows, macOS, Linux üzerinde ve Unity düzenleyicisinin içinden çalışabilen Firebase Unity SDK'larının bir alt kümesini sağlıyoruz.
Mobil platformla aynı talimatları izleyerek bir masaüstü platform Unity projesi oluşturun (yukarıdaki Uygulamanızı Firebase'e kaydedin adımıyla başlayın).
Unity projenizi Unity IDE'de çalıştırın veya Unity projenizi masaüstü için oluşturmayı seçin.
(İsteğe bağlı) Unity projenizi Düzenleme Modunda çalıştırın.
Firebase Unity SDK, Unity'nin düzenleme modunda da çalıştırılabilir, bu da editör eklentilerinde kullanılmasına olanak tanır.
Editör tarafından kullanılan bir
FirebaseApp
oluşturduğunuzda varsayılan örneği kullanmayın.Bunun yerine
FirebaseApp.Create()
çağrısına benzersiz bir ad verin.Unity IDE tarafından kullanılan örnek ile Unity projeniz tarafından kullanılan örnek arasındaki seçeneklerde çakışmayı önlemek için bu önemlidir.
Desteklenen Firebase ürünleri
Referans belgelerinde Unity Firebase kitaplıkları hakkında daha fazla bilgi edinin.
Mobil cihazlar için mevcut Firebase kitaplıkları
Firebase Unity SDK, Apple ve Android'de aşağıdaki Firebase ürünlerini destekler:
Firebase ürünü | Birlik paketi |
---|---|
AdMob | AdMob Unity Eklentisinde ayrı olarak dağıtılır |
Analitik | FirebaseAnalytics.unitypackage |
Uygulama Kontrolü | FirebaseAppCheck.unitypackage |
Kimlik doğrulama | FirebaseAuth.unitypackage |
Bulut Firestore | FirebaseFirestore.unitypackage |
Bulut İşlevleri | FirebaseFunctions.unitypackage |
Bulut Mesajlaşma | FirebaseMessaging.unitypackage (önerilir) FirebaseAnalytics.unitypackage |
Bulut depolama | FirebaseStorage.unitypackage |
Crashlytics | FirebaseCrashlytics.unitypackage (önerilir) FirebaseAnalytics.unitypackage |
Dinamik Bağlantılar | FirebaseDynamicLinks.unitypackage (önerilir) FirebaseAnalytics.unitypackage |
Gerçek Zamanlı Veritabanı | FirebaseDatabase.unitypackage |
Uzaktan Yapılandırma | FirebaseRemoteConfig.unitypackage (önerilir) FirebaseAnalytics.unitypackage |
Masaüstü için mevcut Firebase kitaplıkları
Firebase Unity SDK, bir ürün alt kümesi için masaüstü iş akışı desteği içerir ve Firebase'in belirli bölümlerinin Unity düzenleyicide ve Windows, macOS ve Linux'taki bağımsız masaüstü sürümlerinde kullanılmasına olanak tanır.
Firebase ürünü (masaüstü) | Birlik paketi |
---|---|
Uygulama Kontrolü | FirebaseAppCheck.unitypackage |
Kimlik doğrulama | FirebaseAuth.unitypackage |
Bulut İşlevleri | FirebaseFunctions.unitypackage |
Bulut Firestore | FirebaseFirestore.unitypackage |
Bulut depolama | FirebaseStorage.unitypackage |
Gerçek Zamanlı Veritabanı | FirebaseDatabase.unitypackage |
Uzaktan Yapılandırma | FirebaseRemoteConfig.unitypackage |
Firebase, Windows, macOS ve Linux için derleme yaparken kolaylık sağlamak amacıyla kalan masaüstü kitaplıklarını saplama (işlevsiz) uygulamalar olarak sağlar. Bu nedenle, masaüstünü hedeflemek için kodu koşullu olarak derlemenize gerek yoktur.
Sonraki adımlar
Örnek Firebase uygulamalarını keşfedin.
Uygulamanızı başlatmaya hazırlanın:
- Google Cloud Console'da projeniz için bütçe uyarıları ayarlayın.
- Projenizin birden fazla Firebase hizmetindeki kullanımının genel bir resmini elde etmek için Firebase konsolundaki Kullanım ve faturalandırma kontrol panelini izleyin.
- Firebase başlatma kontrol listesini inceleyin.
Firebase ve Unity projenizle ilgili sorun mu yaşıyorsunuz? Unity sorunlarını giderme ve SSS sayfasını ziyaret edin.