Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Tambahkan Firebase ke proyek Unity Anda

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

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 .

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (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 Android — Emulator harus menggunakan image emulator dengan Google Play.

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.

  1. Buka konsol Firebase .

  2. 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.

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

  4. 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.

  5. (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.

  6. Klik Daftarkan aplikasi .

Langkah 3 : Tambahkan file konfigurasi Firebase

  1. 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 .

  2. Buka jendela Proyek proyek Unity Anda, lalu pindahkan file konfigurasi Anda ke folder Assets .

  3. Kembali ke konsol Firebase, di alur kerja penyiapan, klik Berikutnya .

Langkah 4 : Tambahkan Firebase Unity SDK

  1. 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.

  2. Di proyek Unity Anda yang terbuka, navigasikan ke Assets > Import Package > Custom Package .

  3. 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 dan FirebaseDatabase.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 dan FirebaseDatabase.unitypackage

  4. Di jendela Import Unity Package , klik Import .

  5. 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.

  1. Siapkan proyek Unity platform desktop dengan mengikuti petunjuk yang sama seperti untuk platform seluler (mulai dengan langkah Daftarkan aplikasi Anda dengan Firebase di atas).

  2. Jalankan proyek Unity Anda di Unity IDE atau pilih untuk membangun proyek Unity Anda untuk desktop .

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

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

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

    2. 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