Ikuti semua informasi yang diumumkan di Firebase Summit, dan pelajari bagaimana Firebase dapat membantu Anda mempercepat pengembangan aplikasi dan menjalankan aplikasi dengan percaya diri. Pelajari Lebih Lanjut

Tambahkan Firebase ke proyek Unity Anda

Perkuat game Unity Anda dengan Firebase Unity SDK kami.

Untuk menunjukkan betapa mudahnya memasang 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 (Toko Aplikasi)

MechaHamster (Play Store)


Cari tahu informasi lebih lanjut tentang memperkuat game Anda dengan Firebase di halaman game Firebase kami.

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

Prasyarat

  • Instal Unity 2018.4 atau lebih baru. Versi sebelumnya mungkin juga kompatibel tetapi tidak akan didukung secara aktif. Dukungan untuk Unity 2018.4 dianggap tidak digunakan lagi, dan tidak akan lagi didukung secara aktif setelah rilis besar berikutnya.

  • (Hanya iOS) Instal yang berikut ini:

    • Xcode 13.3.1 atau lebih tinggi
    • CocoaPods 1.10.0 atau lebih tinggi
  • Pastikan proyek Unity Anda memenuhi persyaratan berikut:

    • Untuk iOS — menargetkan iOS 11 atau lebih tinggi
    • Untuk Android — menargetkan API level 19 (KitKat) atau lebih tinggi

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

    • Untuk iOS — Siapkan perangkat iOS fisik atau gunakan simulator iOS.

    • Untuk AndroidEmulator harus menggunakan gambar emulator dengan Google Play.

Jika Anda belum memiliki proyek Unity dan hanya ingin mencoba produk Firebase, Anda dapat mengunduh salah satu contoh panduan memulai kami .

Langkah 1 : Buat proyek Firebase

Sebelum Anda dapat menambahkan Firebase ke proyek Unity, 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 telah menambahkan aplikasi ke proyek Firebase, klik Tambahkan aplikasi untuk menampilkan opsi platform.

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

  4. Masukkan ID khusus platform proyek Unity Anda.

    • Untuk iOS — Masukkan ID iOS proyek Unity Anda di bidang ID bundel iOS .

    • Untuk Android — Masukkan ID Android proyek Unity Anda di bidang nama paket Android .
      Istilah nama paket dan ID aplikasi sering digunakan secara bergantian.

  5. (Opsional) Masukkan nama panggilan khusus platform proyek Unity Anda.
    Julukan ini bersifat internal, pengidentifikasi praktis dan hanya dapat dilihat oleh Anda di konsol Firebase.

  6. Klik Daftar aplikasi .

Langkah 3 : Tambahkan file konfigurasi Firebase

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

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

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

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

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

Langkah 4 : Tambahkan Firebase Unity SDK

  1. Di Firebase console, klik Download Firebase Unity SDK , lalu unzip SDK di tempat yang nyaman.

    • Anda dapat mendownload kembali Firebase Unity SDK kapan saja.

    • Firebase Unity SDK tidak spesifik untuk platform.

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

  3. Dari SDK yang tidak di-zip, pilih produk Firebase yang didukung yang ingin Anda gunakan di aplikasi Anda.

    Analisis diaktifkan

    • Tambahkan paket Firebase untuk Google Analytics: FirebaseAnalytics.unitypackage
    • Tambahkan paket untuk produk Firebase lain 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 Impor Paket Persatuan , klik Impor .

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

Langkah 5 : Konfirmasikan 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 memperbarui 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 mengalami masalah saat menyiapkan, kunjungi Pemecahan masalah & FAQ Unity .

Menyiapkan alur kerja desktop ( beta )

Saat Anda membuat game, sering kali lebih mudah untuk menguji game Anda di editor Unity dan platform desktop terlebih dahulu, lalu menerapkan dan mengujinya di perangkat seluler kemudian 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 untuk panggilan FirebaseApp.Create() .

      Ini penting untuk menghindari konflik dalam opsi antara instans yang digunakan oleh Unity IDE dan instans yang digunakan oleh proyek Unity Anda.

Produk Firebase yang didukung

Pelajari lebih lanjut tentang library Unity Firebase dalam dokumentasi referensi .

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

produk Firebase paket kesatuan
AdMob Didistribusikan secara terpisah di AdMob Unity Plugin
Analitik FirebaseAnalytics.unitypackage
Autentikasi FirebaseAuth.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Fungsi Cloud FirebaseFunctions.unitypackage
Perpesanan 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

Produk Firebase yang didukung (desktop)

Firebase Unity SDK menyertakan dukungan alur kerja desktop untuk subset produk, memungkinkan bagian tertentu dari Firebase untuk digunakan di editor Unity dan di desktop yang berdiri sendiri di Windows, macOS, dan Linux.

Produk Firebase (desktop) paket kesatuan
Autentikasi FirebaseAuth.unitypackage
Fungsi Cloud FirebaseFunctions.unitypackage
Cloud Firestore 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 rintisan (non-fungsional) untuk kenyamanan saat membuat untuk Windows, macOS, dan Linux. Oleh karena itu, Anda tidak perlu mengkompilasi kode secara kondisional untuk menargetkan desktop.

Langkah selanjutnya