Menambahkan Firebase ke project Unity

Tingkatkan game Unity Anda dengan Firebase Unity SDK kami.

Untuk menunjukkan seberapa mudah menambahkan Firebase ke project Unity, kami membuat sampel game, MechaHamster. Jika Anda ingin mencoba menambahkan Firebase ke game, gunakan versi starter yang ada di GitHub. Jika Anda menginginkan versi yang lengkap, lihat versi di App Store atau Google Play Store.

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (Play Store)

Cari tahu informasi lebih lanjut tentang cara meningkatkan performa game Anda dengan Firebase di halaman game Firebase kami.

Pelajari produk Firebase mana yang didukung oleh Firebase Unity SDK.

Sudah menambahkan Firebase ke project Unity Anda? Pastikan Anda menggunakan versi terbaru Firebase Unity SDK.

Prasyarat

• Instal Unity 2021 LTS atau versi yang lebih baru. Dukungan untuk Unity 2020 dianggap sudah tidak berlaku lagi, dan tidak akan lagi didukung secara aktif setelah rilis utama berikutnya. Versi sebelumnya mungkin juga kompatibel, tetapi tidak akan didukung terus-menerus.

• (Khusus platform Apple) Instal aplikasi berikut:

  • Xcode 13.3.1 atau versi yang lebih tinggi
  • CocoaPods 1.12.0 atau versi yang lebih tinggi

• Pastikan project Unity Anda memenuhi persyaratan berikut:

  • Untuk iOS — menarget iOS 13 atau versi yang lebih tinggi
  • Untuk tvOS - menargetkan tvOS 13 atau yang lebih baru
  • Untuk Android — menarget API level 21 (Lollipop) atau versi yang lebih tinggi

• Siapkan perangkat fisik atau gunakan emulator untuk menjalankan aplikasi Anda.

  • Untuk platform Apple — Siapkan perangkat fisik atau gunakan simulator iOS atau tvOS.

    Ingin menggunakan Cloud Messaging?

    Untuk Cloud Messaging di iOS atau tvOS, berikut adalah prasyaratnya:

    • Siapkan perangkat fisik.
    • Dapatkan Kunci Autentikasi Notifikasi Push Apple untuk akun Apple Developer.
    • Di XCode, aktifkan Notifikasi Push di App > Capabilities.

  • Untuk Android — Emulator harus menggunakan image emulator dengan Google Play.

• Login ke Firebase menggunakan akun Google Anda.

Jika belum memiliki project Unity dan hanya ingin mencoba produk Firebase, download salah satu contoh panduan memulai.

Langkah 1: Buat project Firebase

Agar dapat menambahkan Firebase ke project Unity, Anda perlu membuat project Firebase untuk dihubungkan ke project Unity. Buka bagian Memahami Project Firebase untuk mempelajari project Firebase lebih lanjut.

Membuat project Firebase

1. Di Firebase console, klik Add project.

   • Untuk menambahkan resource Firebase ke project Google Cloud yang sudah ada, masukkan nama project-nya atau pilih dari menu dropdown.

   • Untuk membuat project baru, masukkan nama project yang diinginkan. Anda juga dapat mengedit project ID yang ditampilkan di bawah nama project.

     Firebase menghasilkan ID unik untuk project Firebase Anda berdasarkan nama yang Anda berikan. Jika ingin mengedit project ID ini, Anda harus melakukannya sekarang karena project ID tidak dapat diubah setelah Firebase menyediakan resource untuk project Anda. Buka artikel Memahami Project Firebase untuk mempelajari cara Firebase menggunakan project ID.

2. Jika diminta, tinjau dan setujui persyaratan Firebase.

3. Klik Continue.

4. (Opsional) Siapkan Google Analytics untuk project Anda dan optimalkan penggunaan produk-produk Firebase berikut:

   Firebase Crashlytics Firebase Cloud Messaging

   Firebase In-App Messaging Firebase Remote Config

   Personalisasi Remote Config Firebase A/B Testing

   Pilih akun Google Analytics yang ada atau buat akun baru.

   Jika Anda membuat akun baru, pilih lokasi pelaporan Analytics, lalu setujui setelan berbagi data dan persyaratan Google Analytics untuk project Anda.

   Anda dapat sewaktu-waktu menyiapkan Google Analytics dari tab Integrasi di Setelan project Anda.

5. Klik Buat project (atau Tambahkan Firebase, jika Anda menggunakan project Google Cloud yang sudah ada).

Firebase menyediakan resource untuk project Firebase Anda secara otomatis. Begitu selesai, Anda akan dibawa ke halaman ringkasan untuk project Firebase Anda di Firebase console.

Langkah 2: Daftarkan aplikasi Anda ke Firebase

Anda dapat mendaftarkan satu atau beberapa aplikasi atau game untuk dihubungkan dengan project Firebase Anda.

Jika merilis game di iOS dan Android, daftarkan kedua target build project Unity Anda ke project Firebase yang sama. Jika memiliki beberapa varian build dengan ID paket iOS atau ID aplikasi Android yang berbeda, Anda harus mendaftarkan setiap varian ke project Firebase yang sama.

1. Buka Firebase console.

2. Di bagian tengah halaman ringkasan project, klik ikon Unity () untuk meluncurkan alur kerja penyiapan.

   Jika sudah menambahkan aplikasi ke project Firebase, klik Add app untuk menampilkan opsi platform.

3. Pilih target build project Unity yang ingin Anda daftarkan, atau Anda bahkan dapat memilih untuk mendaftarkan kedua target sekaligus.

   Catatan: Jika hanya mendaftarkan satu target build project Unity sekarang, Anda dapat kembali ke alur kerja penyiapan kapan saja untuk mendaftarkan target build lainnya.

4. Masukkan ID khusus platform project Unity Anda.

   • Untuk iOS — Masukkan ID iOS project Unity Anda di kolom iOS bundle ID.

   • Untuk Android — Masukkan ID Android project Unity Anda di kolom Android package name.
     Istilah nama paket dan ID aplikasi memiliki arti yang sama.

   Di mana lokasi ID project Unity?

   Buka project Unity di Unity IDE Anda, lalu buka bagian setelan untuk setiap platform:

   • Untuk iOS — Buka Build Settings > iOS.

   • Untuk Android — Buka Android > Player Settings > Other Settings.

   ID project Unity Anda adalah nilai Bundle Identifier (contoh ID: com.yourcompany.yourproject).

   Pastikan untuk memasukkan ID yang benar-benar digunakan project Anda. Nilai ID peka huruf besar/kecil, dan tidak dapat diubah untuk aplikasi Firebase ini setelah didaftarkan ke project Firebase Anda.

5. (Opsional) Masukkan nama panggilan khusus platform project Unity Anda.
   Nama panggilan ini adalah ID internal praktis yang hanya terlihat oleh Anda di Firebase console.

6. Klik Daftarkan aplikasi.

Langkah 3: Tambahkan file konfigurasi Firebase

1. Dapatkan file konfigurasi Firebase khusus platform Anda di alur kerja penyiapan Firebase console.

   Jika mendaftarkan target build project Unity untuk iOS dan Android, Anda harus mendownload dan menambahkan file konfigurasi untuk kedua platform.

   • Untuk iOS — Klik Download GoogleService-Info.plist.

   • Untuk Android — Klik Download google-services.json.

   Apa yang perlu Anda ketahui tentang file konfigurasi ini?

   • File konfigurasi Firebase berisi ID unik, tetapi tidak bersifat rahasia, untuk project Anda. Untuk mempelajari file konfigurasi ini lebih lanjut, baca Memahami Project Firebase.

   • Anda dapat mendownload file konfigurasi Firebase lagi kapan saja.

   • Pastikan nama file konfigurasi tidak diberi karakter tambahan, seperti (2).

2. Buka jendela Project untuk project Unity Anda, lalu pindahkan file konfigurasi ke folder Assets.

3. Kembali ke Firebase console, di alur kerja penyiapan, klik Next.

Langkah 4: Tambahkan Firebase Unity SDK

Catatan: Alur kerja penyiapan berikut direkomendasikan bagi pengguna pemula Unity SDK. Untuk kasus penggunaan tertentu, Firebase menawarkan alur penyiapan alternatif.

1. Di Firebase console, klik Download Firebase Unity SDK, lalu ekstrak SDK di tempat yang mudah diakses.

   • Anda dapat mendownload Firebase Unity SDK lagi kapan saja.

   • Firebase Unity SDK tidak bersifat khusus untuk platform tertentu.

2. Pada project Unity yang terbuka, buka Aset > Impor Paket > Paket Kustom.

3. Dari SDK yang telah diekstrak, pilih produk Firebase yang didukung yang ingin digunakan dalam aplikasi Anda.

   Analytics diaktifkan

   • Tambahkan paket Firebase untuk Google Analytics: FirebaseAnalytics.unitypackage
   • Tambahkan paket untuk produk Firebase lainnya yang ingin digunakan di aplikasi Anda. Misalnya, untuk menggunakan Firebase Authentication dan Firebase Realtime Database:
     FirebaseAuth.unitypackage dan FirebaseDatabase.unitypackage

   Analytics tidak diaktifkan

   Tambahkan paket untuk produk Firebase yang ingin digunakan di aplikasi Anda. Misalnya, untuk menggunakan Firebase Authentication dan Firebase Realtime Database:
   FirebaseAuth.unitypackage dan FirebaseDatabase.unitypackage

4. Di jendela Import Unity Package, klik Import.

5. Kembali ke Firebase console, di alur kerja penyiapan, klik Next.

Penting: Saat menggunakan Firebase Unity SDK untuk iOS, jangan nonaktifkan method swizzling. Swizzling diperlukan oleh SDK. Jika dinonaktifkan, fitur-fitur penting Firebase (seperti penanganan token FCM) tidak akan berfungsi dengan benar.

Langkah 5: Konfirmasikan persyaratan versi layanan Google Play

Firebase Unity SDK untuk Android memerlukan Google Play services, yang harus diperbarui sebelum SDK dapat digunakan.

Tambahkan pernyataan using dan kode inisialisasi berikut di awal aplikasi Anda. Anda dapat memeriksa dan mengupdate Google Play services secara opsional ke versi yang diperlukan oleh Firebase Unity SDK sebelum memanggil metode lain di 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.
  }
});

Anda sudah siap! Project Unity Anda sudah terdaftar dan dikonfigurasi untuk menggunakan Firebase.

Jika Anda mengalami masalah dalam penyiapan, buka FAQ & pemecahan masalah Unity.

Menyiapkan alur kerja desktop (beta)

Perhatian: Dukungan desktop Firebase Unity SDK adalah fitur beta. Fitur ini hanya ditujukan untuk alur kerja selama pengembangan game Anda, bukan untuk kode pengiriman publik.

Saat Anda membuat game, pengujian game sering kali jauh lebih mudah dilakukan di editor Unity dan di platform desktop terlebih dahulu. Kemudian, Anda bisa men-deploy dan melakukan pengujian di perangkat seluler selama proses pengembangan. Untuk mendukung alur kerja ini, kami menyediakan suubset Firebase Unity SDK yang dapat dijalankan di Windows, macOS, Linux, dan dari dalam editor Unity.

1. Siapkan project Unity platform desktop dengan mengikuti petunjuk yang sama seperti untuk platform seluler (mulai dengan langkah Mendaftarkan aplikasi ke Firebase di atas).

2. Jalankan project Unity Anda di Unity IDE atau pilih untuk mem-build project Unity Anda untuk desktop.

   Catatan: Firebase menemukan file konfigurasi Firebase seluler (GoogleService-Info.plist atau google-services.json) yang Anda tambahkan ke project Unity Anda. Kemudian, dari file konfigurasi seluler, Firebase otomatis akan membuat file konfigurasi Firebase desktop (google-services-desktop.json). File konfigurasi desktop ini berisi project ID Unity yang Anda masukkan dialur kerja penyiapan Firebase console. File ini mengaitkan aplikasi Anda dengan project Firebase Anda.
   
   Jika editor tidak dapat menemukan file konfigurasi desktop, periksa apakah direktori StreamingAssets ada dan file konfigurasi desktop ada di dalamnya.

3. (Opsional) Jalankan project Unity Anda dalam Mode Edit.

   Firebase Unity SDK juga dapat dijalankan dalam mode edit Unity, yang memungkinkan penggunaannya dalam plugin editor.

   1. Saat Anda membuat FirebaseApp yang digunakan oleh editor, jangan gunakan instance default.

   2. Sebagai gantinya, berikan nama unik untuk panggilan FirebaseApp.Create().

      Hal ini penting untuk menghindari konflik dalam menentukan antara instance yang digunakan oleh Unity IDE dan instance yang digunakan oleh project Unity Anda.

Produk Firebase yang didukung

Pelajari lebih lanjut tentang library Firebase Unity di dokumentasi referensi.

Library Firebase yang tersedia untuk perangkat seluler

Firebase Unity SDK mendukung produk Firebase berikut di Apple dan Android:

Catatan: Untuk platform Apple, setiap library Firebase hanya dapat mendukung pemilihan platform Apple OS (iOS, tvOS, dll.). Periksa platform yang didukung oleh setiap library di bagian Pelajari Unity dan Firebase lebih lanjut.

Produk Firebase	Paket Unity
AdMob	Didistribusikan secara terpisah dalam AdMob Unity Plugin
Analytics	FirebaseAnalytics.unitypackage
App Check	FirebaseAppCheck.unitypackage
Authentication	FirebaseAuth.unitypackage
Cloud Firestore	FirebaseFirestore.unitypackage
Cloud Functions	FirebaseFunctions.unitypackage
Cloud Messaging	FirebaseMessaging.unitypackage (direkomendasikan) FirebaseAnalytics.unitypackage
Cloud Storage	FirebaseStorage.unitypackage
Crashlytics	FirebaseCrashlytics.unitypackage (direkomendasikan) FirebaseAnalytics.unitypackage
Dynamic Links	FirebaseDynamicLinks.unitypackage (direkomendasikan) FirebaseAnalytics.unitypackage
Realtime Database	FirebaseDatabase.unitypackage
Remote Config	FirebaseRemoteConfig.unitypackage (direkomendasikan) FirebaseAnalytics.unitypackage

Library Firebase yang tersedia untuk desktop

Firebase Unity SDK memiliki dukungan alur kerja desktop untuk sekumpulan produk, sehingga bagian Firebase tertentu dapat digunakan dalam editor Unity dan dalam build desktop mandiri di Windows, macOS, serta Linux.

Perhatian: Dukungan desktop Firebase Unity SDK adalah fitur beta. Fitur ini hanya ditujukan untuk alur kerja selama pengembangan game Anda, bukan untuk kode pengiriman publik.

Produk Firebase (desktop)	Paket 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 menyediakan library desktop lainnya sebagai implementasi stub (nonfungsional) demi kemudahan saat mem-build aplikasi untuk Windows, macOS, dan Linux. Oleh karena itu, Anda tidak perlu mengompilasi kode secara bersyarat saat menargetkan desktop.

Langkah berikutnya

• Pelajari contoh aplikasi Firebase.

• Bersiap meluncurkan aplikasi Anda:

  • Siapkan pemberitahuan anggaran untuk project Anda di konsol Google Cloud.
  • Pantau dasbor Usage and billing di konsol Firebase untuk mendapatkan gambaran keseluruhan penggunaan project Anda di berbagai layanan Firebase.
  • Periksa checklist peluncuran Firebase.

• Mengalami masalah dengan Firebase dan project Unity Anda? Buka FAQ & pemecahan masalah Unity.