Perkuat game Unity Anda dengan Firebase Unity SDK kami.
Untuk menunjukkan betapa mudahnya menyambungkan Firebase ke proyek Unity Anda, kami membuat contoh game, MechaHamster, yang dapat Anda unduh dari GitHub , App Store , dan Google Play Store .
Temukan informasi lebih lanjut tentang meningkatkan game Anda dengan Firebase di halaman game Firebase kami.
Sudah menambahkan Firebase ke proyek Unity Anda? Pastikan Anda menggunakan Firebase Unity SDK versi terbaru.
Prasyarat
Instal Unity 2019.1 atau lebih baru. Versi sebelumnya mungkin juga kompatibel tetapi tidak akan didukung secara aktif. Dukungan untuk Unity 2019.1 dianggap sudah tidak digunakan lagi, dan tidak akan lagi didukung secara aktif setelah rilis besar berikutnya.
(Hanya platform Apple) Instal yang berikut ini:
- Xcode 13.3.1 atau lebih tinggi
- CocoaPods 1.10.0 atau lebih tinggi
Pastikan project Unity Anda memenuhi persyaratan berikut:
- Untuk iOS — menargetkan iOS 11 atau lebih tinggi
- Untuk tvOS - menargetkan tvOS 12 atau lebih tinggi
- Untuk Android — menargetkan API level 19 (KitKat) atau lebih tinggi
Siapkan perangkat fisik atau gunakan emulator untuk menjalankan aplikasi Anda.
Untuk platform Apple — Siapkan perangkat fisik atau gunakan simulator iOS atau tvOS.
Untuk Cloud Messaging di iOS atau tvOS, berikut prasyaratnya:
- Menyiapkan perangkat fisik .
- Dapatkan Kunci Autentikasi Notifikasi Push Apple untuk akun Pengembang Apple Anda.
- Aktifkan Push Notifications di XCode di bawah App > Capabilities .
Untuk Android — Emulator harus menggunakan image emulator dengan Google Play.
- Masuk ke Firebase menggunakan akun Google Anda.
Jika Anda belum memiliki project Unity dan hanya ingin mencoba produk Firebase, Anda dapat mendownload salah satu contoh quickstart kami.
Langkah 1 : Buat proyek Firebase
Sebelum Anda dapat menambahkan Firebase ke proyek Unity Anda, Anda perlu membuat proyek Firebase untuk terhubung ke proyek Unity Anda. Kunjungi Memahami Proyek Firebase untuk mempelajari lebih lanjut tentang proyek Firebase.
Langkah 2 : Daftarkan aplikasi Anda dengan Firebase
Anda dapat mendaftarkan satu atau beberapa aplikasi atau game untuk terhubung dengan proyek Firebase Anda.
Buka konsol Firebase .
Di tengah halaman ikhtisar proyek, klik ikon Unity (
) untuk meluncurkan alur kerja penyiapan.Jika Anda sudah menambahkan aplikasi ke proyek Firebase, klik Tambahkan aplikasi untuk menampilkan opsi platform.
Pilih target build proyek Unity mana yang ingin Anda daftarkan, atau Anda bahkan dapat memilih untuk mendaftarkan kedua target sekarang sekaligus.
Masukkan ID khusus platform project Unity Anda.
Untuk iOS — Masukkan ID iOS project Unity Anda di bidang ID bundel iOS .
Untuk Android — Masukkan ID Android proyek Unity Anda di kolom nama paket Android .
Istilah nama paket dan ID aplikasi sering digunakan secara bergantian.
Buka proyek Unity Anda di Unity IDE Anda, lalu arahkan ke bagian pengaturan untuk setiap platform:
Untuk iOS — Buka Build Settings > iOS .
Untuk Android — Navigasikan ke Android > Pengaturan Pemain > Pengaturan Lainnya .
ID proyek Unity Anda adalah nilai Pengenal Bundel (contoh ID:
com.yourcompany.yourproject
).(Opsional) Masukkan nama panggilan khusus platform project Unity Anda.
Nama panggilan ini adalah pengidentifikasi kenyamanan internal dan hanya dapat dilihat oleh Anda di konsol Firebase.Klik Daftarkan aplikasi .
Langkah 3 : Tambahkan file konfigurasi Firebase
Dapatkan file konfigurasi Firebase khusus platform Anda di alur kerja penyiapan Firebase console.
Untuk iOS — Klik Unduh GoogleService-Info.plist .
Untuk Android — Klik Unduh google-services.json .
File konfigurasi Firebase berisi pengidentifikasi unik namun tidak rahasia untuk proyek Anda. Untuk mempelajari lebih lanjut tentang file konfigurasi ini, kunjungi Memahami Proyek Firebase .
Anda dapat mengunduh kembali file konfigurasi Firebase Anda kapan saja.
Pastikan nama file konfigurasi tidak ditambahkan dengan karakter tambahan, seperti
(2)
.
Buka jendela Proyek proyek Unity Anda, lalu pindahkan file konfigurasi Anda ke folder
Assets
.Kembali ke konsol Firebase, di alur kerja penyiapan, klik Berikutnya .
Langkah 4 : Tambahkan Firebase Unity SDK
Di konsol Firebase, klik Download Firebase Unity SDK , lalu unzip SDK di tempat yang nyaman.
Anda dapat mendownload Firebase Unity SDK lagi kapan saja.
Firebase Unity SDK tidak khusus platform.
Di proyek Unity Anda yang terbuka, navigasikan ke Assets > Import Package > Custom Package .
Dari SDK yang telah dibuka zipnya, pilih produk Firebase yang didukung yang ingin Anda gunakan di aplikasi Anda.
Analytics diaktifkan
- Tambahkan paket Firebase untuk Google Analytics:
FirebaseAnalytics.unitypackage
- Tambahkan paket untuk produk Firebase lainnya yang ingin Anda gunakan di aplikasi Anda. Misalnya, untuk menggunakan Firebase Authentication dan Firebase Realtime Database:
FirebaseAuth.unitypackage
danFirebaseDatabase.unitypackage
Analytics tidak diaktifkan
Tambahkan paket untuk produk Firebase yang ingin Anda gunakan di aplikasi Anda. Misalnya, untuk menggunakan Firebase Authentication dan Firebase Realtime Database:
FirebaseAuth.unitypackage
danFirebaseDatabase.unitypackage
- Tambahkan paket Firebase untuk Google Analytics:
Di jendela Import Unity Package , klik Import .
Kembali ke konsol Firebase, di alur kerja penyiapan, klik Berikutnya .
Langkah 5 : Konfirmasi persyaratan versi layanan Google Play
Firebase Unity SDK untuk Android memerlukan layanan Google Play , yang harus diperbarui sebelum SDK dapat digunakan.
Tambahkan kode berikut di awal aplikasi Anda. Anda dapat memeriksa dan secara opsional mengupdate layanan Google Play ke versi yang diperlukan oleh Firebase Unity SDK sebelum memanggil metode lain di SDK.
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. } });
Anda sudah siap! Proyek Unity Anda terdaftar dan dikonfigurasi untuk menggunakan Firebase.
Namun, jika Anda kesulitan menyiapkannya, kunjungi Unity troubleshooting & FAQ .
Siapkan alur kerja desktop ( beta )
Saat Anda membuat game, seringkali jauh lebih mudah untuk menguji game Anda di editor Unity dan di platform desktop terlebih dahulu, kemudian menerapkan dan mengujinya di perangkat seluler nanti dalam pengembangan. Untuk mendukung alur kerja ini, kami menyediakan subset Firebase Unity SDK yang dapat berjalan di Windows, macOS, Linux, dan dari dalam editor Unity.
Siapkan proyek Unity platform desktop dengan mengikuti petunjuk yang sama seperti untuk platform seluler (mulai dengan langkah Daftarkan aplikasi Anda dengan Firebase di atas).
Jalankan proyek Unity Anda di Unity IDE atau pilih untuk membangun proyek Unity Anda untuk desktop .
(Opsional) Jalankan proyek Unity Anda dalam Mode Edit.
Firebase Unity SDK juga dapat dijalankan dalam mode edit Unity, memungkinkan penggunaannya dalam plugin editor.
Saat Anda membuat
FirebaseApp
yang digunakan oleh editor, jangan gunakan instance default.Sebagai gantinya, berikan nama unik ke panggilan
FirebaseApp.Create()
.Ini penting untuk menghindari konflik dalam pilihan antara instance yang digunakan oleh Unity IDE dan instance yang digunakan oleh proyek Unity Anda.
Produk Firebase yang didukung
Pelajari lebih lanjut tentang pustaka Unity Firebase dalam dokumentasi referensi .
Pustaka Firebase yang tersedia untuk seluler
Firebase Unity SDK mendukung produk Firebase berikut di Apple dan Android :
produk Firebase | Paket kesatuan |
---|---|
AdMob | Didistribusikan secara terpisah di AdMob Unity Plugin |
Analitik | FirebaseAnalytics.unitypackage |
Autentikasi | FirebaseAuth.unitypackage |
Toko Api Awan | FirebaseFirestore.unitypackage |
Fungsi Awan | FirebaseFunctions.unitypackage |
Pesan Awan | FirebaseMessaging.unitypackage (disarankan) FirebaseAnalytics.unitypackage |
Penyimpanan awan | FirebaseStorage.unitypackage |
Crashlytics | FirebaseCrashlytics.unitypackage (disarankan) FirebaseAnalytics.unitypackage |
Tautan Dinamis | FirebaseDynamicLinks.unitypackage (disarankan) FirebaseAnalytics.unitypackage |
Basis Data Waktu Nyata | FirebaseDatabase.unitypackage |
Konfigurasi Jarak Jauh | FirebaseRemoteConfig.unitypackage (disarankan) FirebaseAnalytics.unitypackage |
Pustaka Firebase yang tersedia untuk desktop
Firebase Unity SDK menyertakan dukungan alur kerja desktop untuk subset produk, memungkinkan bagian tertentu dari Firebase untuk digunakan di editor Unity dan di build desktop mandiri di Windows, macOS, dan Linux.
Produk Firebase (desktop) | Paket kesatuan |
---|---|
Autentikasi | FirebaseAuth.unitypackage |
Fungsi Awan | FirebaseFunctions.unitypackage |
Toko Api Awan | FirebaseFirestore.unitypackage |
Penyimpanan awan | FirebaseStorage.unitypackage |
Basis Data Waktu Nyata | FirebaseDatabase.unitypackage |
Konfigurasi Jarak Jauh | FirebaseRemoteConfig.unitypackage |
Firebase menyediakan pustaka desktop yang tersisa sebagai implementasi stub (non-fungsional) untuk kenyamanan saat membangun untuk Windows, macOS, dan Linux. Oleh karena itu, Anda tidak perlu mengompilasi kode secara kondisional untuk menargetkan desktop.
Langkah selanjutnya
Jelajahi contoh aplikasi Firebase .
Bersiaplah untuk meluncurkan aplikasi Anda:
- Siapkan peringatan anggaran untuk proyek Anda di Google Cloud Console.
- Pantau dasbor Penggunaan dan penagihan di Firebase console untuk mendapatkan gambaran keseluruhan tentang penggunaan proyek Anda di beberapa layanan Firebase.
- Tinjau daftar periksa peluncuran Firebase .
Mengalami masalah dengan Firebase dan project Unity Anda? Kunjungi Unity troubleshooting & FAQ .