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 adlı örnek bir oyun oluşturduk. Bir oyuna Firebase'i 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.
Firebase ile oyunlarınızı güçlendirme hakkında daha fazla bilgi için Firebase oyunları sayfamızı inceleyin.
Firebase'i Unity projenize daha önce eklediniz mi? Firebase Unity SDK'sının en son sürümünü kullandığınızdan emin olun.
Ön koşullar
Unity 2019.1 veya daha yeni bir sürümü yükleyin. Önceki sürümler de uyumlu olabilir ancak aktif olarak desteklenmez. Unity 2019.1 desteği kullanımdan kaldırıldı olarak 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 sonraki sürümler
- CocoaPods 1.12.0 veya sonraki sürümler
Unity projenizin şu koşulları karşıladığından emin olun:
- iOS için — iOS 11 veya sonraki sürümleri hedefler
- tvOS için: tvOS 12 veya sonraki sürümleri hedefler
- Android için — API düzeyi 19 (KitKat) veya sonraki sürümleri hedefler
Uygulamanızı çalıştırmak için fiziksel bir cihaz ayarlayın veya bir emülatör kullanın.
Apple platformları için: Fiziksel bir cihaz kurun veya iOS ya da tvOS simülatörü kullanın.
Android için: Emülatörler, Google Play ile bir emülatör görüntüsü kullanmalıdır.
- Google Hesabınızı kullanarak Firebase'de oturum açın.
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 eklemeden önce Unity projenize bağlanmak için bir Firebase projesi oluşturmanız gerekir. Firebase projeleri hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama sayfasını ziyaret edin.
2. adım: Uygulamanızı Firebase'e kaydedin
Firebase projenize bağlamak için bir veya daha fazla uygulama ya da oyun kaydedebilirsiniz.
Firebase konsoluna gidin.
Kurulum iş akışını başlatmak için projeye genel bakış sayfasının ortasındaki Unity simgesini (
) tıklayın.Firebase projenize daha önce uygulama eklediyseniz platform seçeneklerini görüntülemek için Uygulama ekle'yi tıklayın.
Unity projenizin hangi derleme hedefini kaydetmek istediğinizi seçin. Dilerseniz iki hedefi aynı anda kaydetmeyi de seçebilirsiniz.
Unity projenizin platforma özgü kimliklerini girin.
iOS için: iOS paket kimliği alanına Unity projenizin iOS kimliğini girin.
Android için: Android paket adı alanına Unity projenizin Android kimliğini girin.
Paket adı ve uygulama kimliği terimleri genellikle birbirinin yerine kullanılır.
(İsteğe bağlı) Unity projenizin platforma özgü takma adlarını girin.
Bu takma adlar, dahili kullanım tanımlayıcılarıdır ve bunları Firebase konsolunda yalnızca siz görebilirsiniz.Uygulamayı kaydet'i tıklayın.
3. Adım: Firebase yapılandırma dosyalarını ekleyin
Firebase konsolu kurulum iş akışında platforma özel Firebase yapılandırma dosyalarınızı edinin.
iOS için: GoogleService-Info.plist dosyasını indir'i tıklayın.
Android için: google-services.json'u indir'i tıklayın.
Unity projenizin Proje penceresini açın, ardından yapılandırma dosyalarınızı
Assets
klasörüne taşıyın.Tekrar Firebase konsolunda 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'i 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 özgü değildir.
Açık Unity projenizde Assets > Paketi İçe Aktar > Özel Paket'e gidin.
Sıkıştırılmamış SDK'dan uygulamanızda kullanmak istediğiniz desteklenen Firebase ürünlerini seçin.
Analytics 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
Analytics etkin değil
Uygulamanızda kullanmak istediğiniz Firebase ürünlerinin paketlerini 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'ı tıklayın.
Tekrar Firebase konsolunda kurulum iş akışında İleri'yi tıklayın.
5. adım: Google Play Hizmetleri sürüm gereksinimlerini onaylayın
Android için Firebase Unity SDK'sı Google Play Hizmetleri'nin kullanılabilmesini gerektirir. SDK'nın kullanılabilmesi için bu hizmetlerin güncel olması gerekir.
Aşağıdaki using
ifadesini ve başlatma kodunu uygulamanızın başına ekleyin. SDK'da başka 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.
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.
}
});
Hepsi bu kadar. Unity projeniz Firebase'i kullanacak şekilde kaydedildi ve yapılandırıldı.
Kurulum konusunda sorun yaşıyorsanız Unity sorun giderme ve SSS sayfasını ziyaret edin.
Masaüstü iş akışı oluşturma (beta)
Bir oyun oluştururken, öncelikle oyununuzu Unity Düzenleyici'de ve masaüstü platformlarında test etmek, ardından geliştirme aşamasında mobil cihazlarda dağıtıp test etmek genellikle çok daha kolaydır. Bu iş akışını desteklemek için Windows, macOS, Linux ve Unity düzenleyicide çalışabilen Firebase Unity SDK'larının alt kümesini sağlıyoruz.
Mobil platform için geçerli olan talimatları uygulayarak masaüstü platformu Unity projesi oluşturun (yukarıdaki Uygulamanızı Firebase'e kaydetme adımıyla başlayın).
Unity projenizi Unity IDE'de çalıştırın veya Unity projenizi masaüstü için derlemeyi seçin.
(İsteğe bağlı) Unity projenizi Düzenleme Modu'nda çalıştırın.
Firebase Unity SDK'sı, Unity'nin düzenleme modunda da çalıştırılarak düzenleyici eklentilerinde kullanılmasına olanak tanır.
Düzenleyici 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 girin.Unity IDE tarafından kullanılan örnek ile Unity projeniz tarafından kullanılan örnek arasındaki seçenekler arasında çakışma olmaması için bu önemlidir.
Desteklenen Firebase ürünleri
Unity Firebase kitaplıkları hakkında daha fazla bilgi edinmek için referans belgelerine göz atın.
Mobil cihazlar için kullanılabilir Firebase kitaplıkları
Firebase Unity SDK'sı Apple ve Android'de aşağıdaki Firebase ürünlerini destekler:
Firebase ürünü | Unity paketi |
---|---|
AdMob | AdMob Unity Eklentisinde ayrı olarak dağıtılır |
Analizler | FirebaseAnalytics.unitypackage |
Uygulama Kontrolü | FirebaseAppCheck.unitypackage |
Kimlik Doğrulama | FirebaseAuth.unitypackage |
Cloud Firestore | FirebaseFirestore.unitypackage |
Cloud Functions | FirebaseFunctions.unitypackage |
Bulut Mesajlaşma | FirebaseMessaging.unitypackage (önerilir) FirebaseAnalytics.unitypackage |
Cloud Storage | FirebaseStorage.unitypackage |
Crashlytics | FirebaseCrashlytics.unitypackage (önerilir) FirebaseAnalytics.unitypackage |
Dinamik Bağlantılar | FirebaseDynamicLinks.unitypackage (önerilir) FirebaseAnalytics.unitypackage |
Gerçek Zamanlı Veritabanı | FirebaseDatabase.unitypackage |
Remote Config | FirebaseRemoteConfig.unitypackage (önerilir) FirebaseAnalytics.unitypackage |
Masaüstü için kullanılabilir Firebase kitaplıkları
Firebase Unity SDK'sı ürünlerin bir alt kümesi için masaüstü iş akışı desteği sunar. Böylece Firebase'in belirli bölümlerinin Unity Editor'da ve Windows, macOS ve Linux'taki bağımsız masaüstü derlemelerinde kullanılabilmesini sağlar.
Firebase ürünü (masaüstü) | Unity paketi |
---|---|
Uygulama Kontrolü | FirebaseAppCheck.unitypackage |
Kimlik Doğrulama | FirebaseAuth.unitypackage |
Cloud Functions | FirebaseFunctions.unitypackage |
Cloud Firestore | FirebaseFirestore.unitypackage |
Cloud Storage | FirebaseStorage.unitypackage |
Gerçek Zamanlı Veritabanı | FirebaseDatabase.unitypackage |
Remote Config | FirebaseRemoteConfig.unitypackage |
Firebase; Windows, macOS ve Linux için geliştirme yaparken kalan masaüstü kitaplıklarını taslak (çalışmayan) uygulamalar olarak sağlar. Bu nedenle, masaüstünü hedeflemek için kodu koşullu olarak derlemeniz gerekmez.
Sonraki adımlar
Örnek Firebase uygulamalarını keşfedin.
Uygulamanızı kullanıma sunmaya hazırlanma:
- Google Cloud Console'da projeniz için bütçe uyarıları oluşturun.
- Birden çok Firebase hizmeti genelinde projenizin kullanımıyla ilgili genel bir fikir edinmek için Firebase konsolundaki Kullanım ve faturalandırma kontrol panelini izleyin.
- Firebase lansmanı kontrol listesini inceleyin.
Firebase ve Unity projenizle ilgili sorun mu yaşıyorsunuz? Unity sorun giderme ve SSS sayfasını ziyaret edin.