Google is committed to advancing racial equity for Black communities. See how.
Эта страница была переведа с помощью Cloud Translation API.
Switch to English

Начните работу с Firebase Remote Config для Unity

Вы можете использовать Firebase Remote Config для определения параметров в вашем приложении и обновления их значений в облаке, что позволяет вам изменять внешний вид и поведение вашего приложения без распространения обновления приложения.

Библиотека Remote Config используется для хранения значений параметров по умолчанию в приложении, получения обновленных значений параметров из серверной части Remote Config и управления тем, когда полученные значения становятся доступными для вашего приложения. Чтобы узнать больше, см. Стратегии загрузки Remote Config .

В этом руководстве представлены пошаговые инструкции по началу работы и несколько примеров кода, которые можно клонировать или загрузить из репозитория firebase / quickstart-unity на GitHub.

Добавьте Remote Config в свое приложение

Прежде чем вы сможете использовать Remote Config , вам необходимо:

  • Зарегистрируйте свой проект Unity и настройте его для использования Firebase.

    • Если ваш проект Unity уже использует Firebase, значит, он уже зарегистрирован и настроен для Firebase.

    • Если у вас нет проекта Unity, вы можете загрузить образец приложения .

  • Добавьте Firebase Unity SDK (в частности, FirebaseRemoteConfig.unitypackage ) в свой проект Unity.

Обратите внимание, что добавление Firebase в ваш проект Unity включает задачи как в консоли Firebase, так и в вашем открытом проекте Unity (например, вы загружаете файлы конфигурации Firebase из консоли, а затем перемещаете их в свой проект Unity).

Установить значения параметров по умолчанию в приложении

Вы можете установить значения параметров по умолчанию в объекте Remote Config, которые будут использоваться, если никакие другие значения не были получены из серверной части. Это позволяет вашему приложению вести себя должным образом до того, как оно подключится к серверной части Remote Config.

Для этого создайте строковый словарь и заполните его парами ключ / значение, представляющими значения по умолчанию, которые вы хотите добавить. (Нестроковые свойства будут преобразованы в тип свойства при вызове SetDefaults .)

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);

Получите значения параметров для использования в вашем приложении

Теперь вы можете получать значения параметров из объекта Remote Config. Если вы задали значения в серверной части Remote Config, получили их, а затем активировали, эти значения станут доступны вашему приложению. В противном случае вы получите значения параметров в приложении, настроенные с помощью SetDefaults () .

Чтобы получить эти значения, используйте GetValue () , указав ключ параметра в качестве аргумента. Это возвращает ConfigValue , у которого есть свойства для преобразования значения в различные базовые типы.

Подключите свое приложение в консоли Firebase

В консоли Firebase добавьте свое приложение в проект Firebase.

Установить значения параметров

  1. В консоли Firebase откройте свой проект.
  2. Выберите Remote Config из меню, чтобы просмотреть панель Remote Config.
  3. Определите параметры с теми же именами, что и параметры, которые вы определили в своем приложении. Для каждого параметра вы можете установить значение по умолчанию (которое в конечном итоге переопределит значение по умолчанию в приложении) и условные значения. Чтобы узнать больше, см. Параметры и условия Remote Config .

Получение и активация значений (при необходимости)

Чтобы получить значения параметров из серверной части Remote Config, вызовите метод FetchAsync() . Любые значения, которые вы устанавливаете на серверной части, выбираются и кэшируются в объекте 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.FetchAsync(
      TimeSpan.Zero);
  return fetchTask.ContinueWithOnMainThread(FetchComplete);
}

Значения, FetchAsync() помощью FetchAsync() , кэшируются локально после завершения выборки, но не становятся доступными до тех пор, пока не будет вызвана ActivateFetched() . Поскольку FetchAsync() выполняется асинхронно, это позволяет гарантировать, что новые значения не применяются в середине вычисления или в другое время, которое может вызвать проблемы или странное поведение.

(Необязательно) Включить режим разработчика

Чтобы включить режим разработчика, который можно использовать для отключения регулирования во время разработки, вы можете использовать свойство FirebaseRemoteConfig.Setting , установив для нового ConfigSettings с IsDeveloperMode значение true.

Следующие шаги

Если вы еще этого не сделали, изучите варианты использования Remote Config и ознакомьтесь с некоторыми ключевыми концепциями и документацией по расширенным стратегиям, включая: