Google is committed to advancing racial equity for Black communities. See how.
Bu sayfa, Cloud Translation API ile çevrilmiştir.
Switch to English

Firebase Remote Config for Unity'yi Kullanmaya Başlayın

Uygulamanızda parametreleri tanımlamak ve buluttaki değerlerini güncellemek için Firebase Remote Config'i kullanarak, bir uygulama güncellemesi dağıtmadan uygulamanızın görünümünü ve davranışını değiştirmenize olanak tanır.

Remote Config kitaplığı, uygulama içi varsayılan parametre değerlerini depolamak, Remote Config arka ucundan güncellenmiş parametre değerlerini almak ve getirilen değerlerin uygulamanıza ne zaman sunulacağını kontrol etmek için kullanılır. Daha fazla bilgi edinmek için bkz. Remote Config yükleme stratejileri .

Bu kılavuz, başlangıç ​​adımlarında size yol gösterir ve tümü firebase / quickstart-unity GitHub deposundan klonlamak veya indirmek için mevcut olan bazı örnek kodlar sağlar.

Uygulamanıza Remote Config ekleyin

Remote Config'i kullanmadan önce yapmanız gerekenler:

  • Unity projenizi kaydedin ve Firebase'i kullanacak şekilde yapılandırın.

    • Unity projeniz zaten Firebase kullanıyorsa, zaten kaydedilmiş ve Firebase için yapılandırılmıştır.

    • Bir Unity projeniz yoksa, örnek bir uygulama indirebilirsiniz.

  • Firebase Unity SDK'sını (özellikle FirebaseRemoteConfig.unitypackage ) Unity projenize ekleyin.

Unity projenize Firebase eklemenin hem Firebase konsolunda hem de açık Unity projenizde görevler içerdiğini unutmayın (örneğin, Firebase yapılandırma dosyalarını konsoldan indirir, ardından bunları Unity projenize taşırsınız).

Uygulama içi varsayılan parametre değerlerini ayarlayın

Remote Config nesnesinde, arka uçtan başka değerler alınmadıysa kullanılacak varsayılan parametre değerlerini ayarlayabilirsiniz. Bu, uygulamanızın Remote Config arka ucuna bağlanmadan önce amaçlandığı gibi davranmasını sağlar.

Bunu yapmak için, bir dize sözlüğü oluşturun ve eklemek istediğiniz varsayılanları temsil eden anahtar / değer çiftleriyle doldurun. (Dize olmayan özellikler, SetDefaults çağrıldığında özelliğin türüne dönüştürülecektir.)

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.SetDefaults(defaults);

Uygulamanızda kullanmak için parametre değerlerini alın

Artık Remote Config nesnesinden parametre değerleri alabilirsiniz. Remote Config arka ucunda değerler ayarlarsanız, bunları alırsanız ve ardından etkinleştirirseniz, bu değerler uygulamanızda kullanılabilir. Aksi takdirde, SetDefaults () kullanılarak yapılandırılan uygulama içi parametre değerlerini alırsınız .

Bu değerleri almak için, parametre anahtarını bağımsız değişken olarak sağlayarak GetValue () kullanın. Bu, değeri çeşitli temel türlere dönüştürmek için özelliklere sahip bir ConfigValue döndürür.

Uygulamanızı Firebase konsolunda bağlayın

Firebase konsolunda , uygulamanızı Firebase projenize ekleyin.

Parametre değerlerini ayarlayın

  1. Firebase konsolunda projenizi açın.
  2. Remote Config panosunu görüntülemek için menüden Remote Config'i seçin.
  3. Uygulamanızda tanımladığınız parametrelerle aynı adlara sahip parametreleri tanımlayın. Her parametre için varsayılan bir değer (sonunda uygulama içi varsayılan değeri geçersiz kılar) ve koşullu değerler ayarlayabilirsiniz. Daha fazla bilgi edinmek için bkz. Remote Config parametreleri ve koşulları .

Değerleri alın ve etkinleştirin (gerektiği gibi)

Remote Config arka FetchAsync() parametre değerlerini almak için FetchAsync() yöntemini çağırın. Arka uçta ayarladığınız tüm değerler, Remote Config nesnesinde alınır ve önbelleğe alınır.

// 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.FetchAsync(
      TimeSpan.Zero);
  return fetchTask.ContinueWithOnMainThread(FetchComplete);
}

FetchAsync() aracılığıyla getirilen değerler, getirme tamamlandığında yerel olarak önbelleğe alınır, ancak ActivateFetched() çağrılana kadar kullanılamaz. FetchAsync() eşzamansız olarak yürütüldüğünden, bu, yeni değerlerin hesaplamanın ortasında veya sorunlara veya garip davranışlara neden olabilecek diğer zamanlarda uygulanmamasını sağlar.

(İsteğe bağlı) Geliştirici modunu etkinleştirin

Gelişimi sırasında devre dışı daraltma için kullanılabilir geliştirici modunu etkinleştirmek için kullanabilirsiniz FirebaseRemoteConfig.Setting yeni ayar, özellik ConfigSettings ile IsDeveloperMode true seti.

Sonraki adımlar

Henüz yapmadıysanız, Remote Config kullanım örneklerini keşfedin ve aşağıdakiler dahil bazı temel kavramlara ve gelişmiş strateji belgelerine göz atın: