Anda bisa menggunakan Firebase Remote Config untuk menetapkan parameter dalam aplikasi dan memperbarui value-nya 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 terbaru dari backend Remote Config, dan mengontrol kapan value yang diambil akan tersedia untuk aplikasi Anda. Untuk mempelajari lebih lanjut, baca artikel Strategi pemuatan Remote Config.
Panduan ini akan menuntun Anda menjalankan langkah-langkah untuk memulai, serta menyediakan beberapa kode contoh, yang semuanya dapat di-clone atau didownload dari repositori GitHub firebase/quickstart-unity.
Menambahkan Remote Config ke aplikasi
Sebelum dapat menggunakan Remote Config, Anda perlu:
Mendaftarkan project Unity Anda dan mengonfigurasikannya agar dapat menggunakan Firebase.
Jika project Unity Anda telah menggunakan Firebase, berarti project tersebut telah terdaftar dan dikonfigurasi 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 penambahan Firebase ke project Unity Anda memerlukan tindakan baik di Firebase console maupun di project Unity yang terbuka (misalnya, Anda mendownload file konfigurasi Firebase dari console, lalu memindahkannya ke project Unity).
Menetapkan parameter value default dalam aplikasi
Anda bisa menetapkan parameter value default dalam aplikasi di objek Remote Config agar aplikasi Anda berperilaku seperti yang diharapkan sebelum terhubung ke backend Remote Config, dan agar ada value default yang tersedia jika tidak ada value yang ditetapkan pada backend.
Untuk melakukannya, buatlah kamus string, dan isi dengan key-value pair yang mewakili default yang ingin Anda tambahkan. Jika sudah mengonfigurasi parameter value backend Remote Config, Anda dapat mendownload file yang berisi key-value pair ini dan menggunakannya untuk membuat kamus string. Untuk mengetahui informasi selengkapnya, baca artikel Mendownload default template Remote Config.
(Properti yang bukan string akan
dikonversi ke jenis properti saat SetDefaultsAsync()
dipanggil).
System.Collections.Generic.Dictionary<string, object> defaults = new System.Collections.Generic.Dictionary<string, object>(); // These are the values that are used if we haven't fetched data from the // server // yet, or if we ask for values that the server doesn't have: defaults.Add("config_test_string", "default local string"); defaults.Add("config_test_int", 1); defaults.Add("config_test_float", 1.0); defaults.Add("config_test_bool", false); Firebase.RemoteConfig.FirebaseRemoteConfig.DefaultInstance.SetDefaultsAsync(defaults) .ContinueWithOnMainThread(task => {
Mendapatkan parameter value yang akan digunakan dalam aplikasi Anda
Sekarang Anda bisa mendapatkan parameter value dari objek Remote Config. Jika Anda menetapkan value di backend Remote Config, mengambilnya, lalu mengaktifkannya, value tersebut akan tersedia untuk aplikasi Anda. Jika tidak, Anda akan mendapatkan parameter value dalam aplikasi yang dikonfigurasi menggunakan SetDefaultsAsync()
.
Untuk mendapatkan value ini, gunakan GetValue()
, dengan kunci parameter sebagai argumen. Tindakan ini menampilkan ConfigValue
yang memiliki properti untuk mengonversi value ke dalam berbagai jenis dasar.
Menghubungkan aplikasi di Firebase console
Di Firebase console, tambahkan aplikasi Anda ke project Firebase.
Menetapkan parameter value
- Buka project Anda di Firebase console.
- Pilih Remote Config dari menu untuk melihat dasbor Remote Config.
- Tetapkan parameter dengan nama yang sama dengan parameter yang Anda tetapkan dalam aplikasi. Untuk setiap parameter, Anda dapat menetapkan value default (yang pada akhirnya akan mengganti value default dalam aplikasi) dan Anda juga dapat menetapkan value kondisional. Untuk mempelajari lebih lanjut, baca artikel Parameter dan kondisi Remote Config.
Mengambil dan mengaktifkan value (jika perlu)
Untuk mengambil parameter value dari backend Remote Config, panggil
metode
FetchAsync()
. Setiap value yang Anda tetapkan pada backend akan diambil dan disimpan dalam cache di objek Remote Config.
// Start a fetch request. // FetchAsync only fetches new data if the current data is older than the provided // timespan. Otherwise it assumes the data is "recent enough", and does nothing. // By default the timespan is 12 hours, and for production apps, this is a good // number. For this example though, it's set to a timespan of zero, so that // changes in the console will always show up immediately. public Task FetchDataAsync() { DebugLog("Fetching data..."); System.Threading.Tasks.Task fetchTask = Firebase.RemoteConfig.FirebaseRemoteConfig.DefaultInstance.FetchAsync( TimeSpan.Zero); return fetchTask.ContinueWithOnMainThread(FetchComplete); }
Value yang diambil melalui FetchAsync()
akan disimpan ke dalam cache secara lokal saat pengambilan
selesai, tetapi tidak akan tersedia sampai ActivateFetched()
dipanggil. Karena FetchAsync()
dijalankan secara asinkron, Anda dapat
memastikan bahwa value 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
. Tetapkan ConfigSettings
baru dengan IsDeveloperMode
ditetapkan ke true (benar).
Langkah berikutnya
Pelajari kasus penggunaan Remote Config jika Anda belum melakukannya, dan lihat beberapa dokumentasi strategi lanjutan dan konsep utama, termasuk: