Menambahkan Firebase ke project Unity

Tingkatkan game Unity Anda dengan Firebase Unity SDK.

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)


Temukan informasi lebih lanjut tentang cara meningkatkan game Anda dengan Firebase di halaman game Firebase.

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

Prasyarat

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

  • (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 — menargetkan iOS 11 atau versi yang lebih tinggi
    • Untuk tvOS - menargetkan tvOS 12 atau yang lebih baru
    • Untuk Android — menarget API level 19 (KitKat) 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.

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

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.

Langkah 2: Daftarkan aplikasi Anda ke Firebase

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

  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.

  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.

  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 Register app.

Langkah 3: Tambahkan file konfigurasi Firebase

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

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

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

  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

  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 khusus untuk platform tertentu.

  2. Di dalam project Unity, buka Assets > Import Package > Custom Package.

  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.

Langkah 5: Konfirmasi persyaratan versi layanan Google Play

Firebase Unity SDK untuk Android memerlukan layanan Google Play versi terbaru agar SDK dapat digunakan.

Tambahkan pernyataan using dan kode inisialisasi berikut di awal aplikasi Anda. Anda dapat memeriksa dan mengupdate layanan Google Play 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)

Saat Anda membuat game, pengujian game sering kali jauh lebih mudah dilakukan di editor Unity dan di platform desktop terlebih dahulu. Kemudian, Anda dapat men-deploy dan melakukan pengujian di perangkat seluler setelahnya. Untuk mendukung alur kerja ini, kami menyediakan beberapa fitur 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.

  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:

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.

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