Buka konsol

Memulai Firebase Remote Config untuk Unity

Anda bisa menggunakan Firebase Remote Config untuk menetapkan parameter dalam aplikasi dan mengupdate nilainya di cloud, yang memungkinkan Anda untuk memodifikasi tampilan dan perilaku aplikasi tanpa mendistribusikan update aplikasi.

Library Remote Config digunakan untuk menyimpan parameter value default dalam aplikasi, mengambil parameter value yang telah diupdate, dan mengontrol kapan nilai yang diambil akan tersedia untuk aplikasi Anda. Untuk mempelajari lebih lanjut, lihat Ringkasan Remote Config API.

Menambahkan Remote Config ke aplikasi

Sebelum dapat menggunakan Remote Config, Anda perlu:

  • Mendaftarkan project Unity Anda dan mengonfigurasikannya untuk menggunakan Firebase.

    • Jika project Unity Anda telah menggunakan Firebase, berarti project tersebut telah terdaftar dan dikonfigurasikan untuk Firebase.

    • Jika belum memiliki project Unity, Anda dapat mendownload aplikasi contoh.

  • Menambahkan Firebase Unity SDK (khususnya, FirebaseRemoteConfig.unitypackage) ke project Unity Anda.

Perlu diperhatikan bahwa menambahkan Firebase ke project Unity Anda melibatkan tugas di Firebase console dan di project Unity yang terbuka (misalnya, Anda mendownload file konfigurasi Firebase dari konsol, lalu memindahkannya ke project Unity).

Menetapkan parameter value default dalam aplikasi

Anda dapat menyetel parameter value default dalam objek Remote Config, yang akan digunakan jika tidak ada nilai lain yang diambil dari layanan. Tindakan ini memungkinkan aplikasi Anda untuk berperilaku seperti yang diinginkan sebelum terhubung dengan layanan Remote Config.

Untuk melakukan ini, buatlah kamus string, dan isi dengan key-value pair yang mewakili default yang Anda ingin tambahkan. (Properti yang bukan string akan dikonversi ke jenis properti saat SetDefaults dipanggil.)

System.Collections.Generic.Dictionary defaults =
  new System.Collections.Generic.Dictionary();

// These are the values that are used if we haven't fetched data from the
// service yet, or if we ask for values that the service doesn't have:
defaults.Add("propertyname_string", "default local string");
defaults.Add("propertyname_int", 1);
defaults.Add("propertyname_float", 1.0);
defaults.Add("propertyname_bool", false);

Firebase.RemoteConfig.FirebaseRemoteConfig.SetDefaults(defaults);

Mendapatkan parameter value yang akan digunakan dalam aplikasi

Sekarang Anda bisa mendapatkan parameter value dari objek Remote Config. Jika Anda menetapkan nilai pada layanan Remote Config, mengambilnya kemudian mengaktifkannya, nilai tersebut akan tersedia untuk aplikasi Anda. Jika tidak, Anda mendapatkan parameter value dalam aplikasi yang terkonfigurasi dengan menggunakan SetDefaults().

Untuk mendapatkan nilai ini, gunakan GetValue (), yang menyediakan kunci parameter sebagai argumen. Tindakan ini menampilkan ConfigValue, yang memiliki properti untuk mengonversi nilai ke dalam berbagai jenis dasar.

Menghubungkan aplikasi di Firebase console

Di Firebase console, tambahkan aplikasi Anda ke project Firebase.

Menetapkan parameter value dalam layanan (jika perlu)

  1. Buka project Anda di Firebase console.
  2. Pilih Remote Config dari menu untuk melihat dasbor Remote Config.
  3. Tetapkan parameter dengan nama yang sama dengan parameter yang Anda tetapkan dalam aplikasi. Untuk setiap parameter, Anda bisa menetapkan nilai default (yang pada akhirnya akan mengganti nilai default dalam aplikasi) dan nilai kondisional. Untuk mempelajari lebih lanjut, lihat parameter dan kondisi Remote Config.

Mengambil dan mengaktifkan nilai dari layanan (jika perlu)

Untuk mengambil parameter value dari layanan Remote Config, panggil metode FetchAsync(). Setiap nilai yang Anda tetapkan pada layanan Remote Config akan diambil dan disimpan dalam cache di objek Remote Config.

Nilai yang diambil melalui FetchAsync() disimpan ke dalam cache lokal saat pengambilan selesai, tetapi tidak tersedia sampai ActivateFetched() dipanggil. Karena FetchAsync() tidak berjalan secara bersamaan, Anda dapat memastikan bahwa nilai yang baru tidak akan diterapkan di tengah-tengah penghitungan atau pada waktu lain yang dapat menyebabkan masalah atau perilaku aneh.

(Opsional) Mengaktifkan mode developer

Untuk mengaktifkan mode developer, yang dapat digunakan untuk menonaktifkan throttling selama tahap pengembangan, Anda dapat menggunakan properti FirebaseRemoteConfig.Setting, sehingga menetapkan ConfigSettings baru dengan IsDeveloperMode ditetapkan ke true.