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 örnek oyun, MechaHamster. Firebase'i bir oyuna eklemeyi denemek isterseniz GitHub'da bulunan başlangıç sürümü. Tamamlanmış bir sürüm istiyorsanız App Store veya Google Play Store'daki sürümlerini öğrenebilirsiniz.
Firebase ile oyunlarınızı güçlendirme hakkında daha fazla bilgi için Firebase oyunları sayfası.
Firebase'i Unity projenize daha önce eklediniz mi? Şunu kullandığınızdan emin olun: Firebase Unity SDK'nın son sürümüne gidin.
Ön koşullar
Unity 2019.1 veya daha yeni bir sürümü yükleyin. Önceki sürümler de uyumlu olabilir aktif olarak desteklenmeyecektir. Unity 2019.1 desteği dikkate alınır desteği sonlandırılmıştır ve sonraki önemli aşamalardan sonra kullanabilirsiniz.
(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'u hedefler (KitKat) veya sonraki sürümler
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 kullanın. simülatörüdür.
Android için — Emülatörler, emülatör resmi kullanabilirsiniz.
- Google Hesabınızla Firebase'de oturum açın hesap.
Henüz Unity projeniz yoksa ve bir Firebase'i denemek istiyorsanız hızlı başlangıç örneklerimizden birini indirebilirsiniz.
1. Adım: Firebase projesi oluşturun
Firebase'i Unity projenize eklemeden önce bir Firebase oluşturmanız gerekir Unity projenize bağlanacak. Ziyaret edin: Şu konular hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama: Firebase projeleri.
2. adım: Uygulamanızı Firebase'e kaydedin
Firebase'inize bağlanmak için bir veya daha fazla uygulama ya da oyun kaydedebilirsiniz belirler.
Firebase konsoluna gidin.
Projeye genel bakış sayfasının ortasındaki Unity simgesini tıklayın (
) kurulum iş akışını başlatın.Firebase projenize daha önce uygulama eklediyseniz Uygulama ekle'yi tıklayın tıklayın.
Kaydetmek istediğiniz Unity projenizin derleme hedefini seçin, ya da her iki hedefi aynı anda kaydetmeyi seçebilirsiniz.
Unity projenizin platforma özgü kimliklerini girin.
iOS için: Unity projenizin iOS kimliğini iOS paketi Kimlik girin.
Android için: Unity projenizin Android kimliğini Android paketi name alanında oturum açın.
. Paket adı ve uygulama kimliği terimleri genellikle kullanabilirsiniz.
(İsteğe bağlı) Unity projenizin platforma özgü takma adlarını girin.
. Bu takma adlar dahili, kolaylık tanımlayıcılarıdır ve yalnızca görebilirsiniz.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 kurulumu iş akışı.
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çıp yapılandırmanızı taşıyın dosyayı
Assets
klasörüne kopyalayı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'sını İndir'i tıklayın, ardından sıkıştırılmış dosyayı açın SDK'yı uygun bir yere koyabilirsiniz.
Firebase Unity SDK'yı istediğiniz zaman tekrar indirebilirsiniz.
Firebase Unity SDK platforma özgü değildir.
Açık Unity projenizde şuraya gidin: Öğeler > Paketi İçe Aktar > Özel Paket.
Sıkıştırılmamış SDK'dan desteklenen Firebase'i seçin. ürün testlerini en iyi şekilde yararlanabilirsiniz.
Analytics etkin
- Google Analytics için Firebase paketini ekleyin:
FirebaseAnalytics.unitypackage
. - Kullanmak istediğiniz diğer tüm Firebase ürünlerinin paketlerini ekleyin
en iyi şekilde yararlanabilirsiniz. Örneğin, Firebase Authentication ve
Firebase Gerçek Zamanlı Veritabanı:
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 kullanılabilmesi için uygulamanın güncel tutulması gerekir.
Aşağıdaki using
ifadesini ve başlatma kodunu
kabul edersiniz. Google Play hizmetlerini şurada kontrol edebilir ve isterseniz güncelleyebilirsiniz:
başka bir kod çağırmadan önce Firebase Unity SDK'sının gerektirdiği sürümü
yöntemlerine göz atacağız.
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ı.
Ancak kurulum konusunda sorun yaşıyorsanız şu sayfayı ziyaret edin: Unity sorunlarını giderme ve SSS.
Masaüstü iş akışı oluşturma (beta)
Bir oyun oluştururken, oyununuzu uygulama içinde test etmek çoğu zaman Önce Unity Editor ve masaüstü platformlarında, ardından mobil cihazlarda dağıtıp test edin geliştirmede kullanılabilir. Bu iş akışını desteklemek için çalıştırabilen Firebase Unity SDK'larının alt kümesi Windows, macOS, Linux ve Unity düzenleyicisinden yararlanabilir.
Aşağıdaki talimatları uygulayarak bir masaüstü platformu Unity projesi oluşturun: ( Uygulamanızı Firebase'e kaydedin adımına bakın).
Unity projenizi Unity IDE'de çalıştırın veya Unity'nizi derlemek için seçin masaüstü projesidir.
(İ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ılabilir.
Düzenleyici tarafından kullanılan bir
FirebaseApp
oluşturduğunuzda, varsayılan örneğidir.Bunun yerine,
FirebaseApp.Create()
çağrısına benzersiz bir ad girin.Bu, kullanılan örnek arasındaki seçeneklerin çakışmasını önlemek için önemlidir Unity IDE ve Unity projeniz tarafından kullanılan örnek tarafından oluşturulan bir veri kümesidir.
Desteklenen Firebase ürünleri
Unity Firebase kitaplıkları hakkında daha fazla bilgiyi şurada bulabilirsiniz: referans belgeleri.
Mobil cihazlar için kullanılabilir Firebase kitaplıkları
Firebase Unity SDK'sı şu Firebase ürünlerini destekler: Apple ve Android:
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ı masaüstü iş akışı desteği içerir kullanarak Firebase'in belirli kısımlarının Unity düzenleyici ve Windows, macOS ve Linux'taki bağımsız masaüstü derlemelerinde.
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, kalan masaüstü kitaplıklarını taslak olarak sağlar (işlevsel değildir) uygulamaları geliştiriyoruz. 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:
- Bütçe ayarlama uyarılar Google Cloud Console'da görüntüleyebilirsiniz.
- Kullanımı ve faturalandırmayı izleme kontrol paneli Firebase konsolunda projenizin genel görünümüne birden fazla Firebase hizmetinde nasıl kullanıldığını gösterir.
- Firebase lansmanı kontrol listesini inceleyin.
Firebase ve Unity projenizle ilgili sorun mu yaşıyorsunuz? Unity sorun giderme ve SSS.