Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Comience con Firebase Remote Config

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.


Puede usar Firebase Remote Config para definir parámetros en su aplicación y actualizar sus valores en la nube, lo que le permite modificar la apariencia y el comportamiento de su aplicación sin distribuir una actualización de la aplicación.

La biblioteca de Remote Config se usa para almacenar valores de parámetros predeterminados en la aplicación, obtener valores de parámetros actualizados desde el backend de Remote Config y controlar cuándo los valores obtenidos están disponibles para su aplicación. Para obtener más información, consulte Estrategias de carga de Remote Config .

Esta guía lo guía a través de los pasos para comenzar y proporciona un código de muestra, todo el cual está disponible para clonar o descargar desde el repositorio de GitHub de firebase/quickstart-unity .

Paso 1: Agrega Remote Config a tu aplicación

Antes de poder usar Remote Config , debe:

  • Registra tu proyecto de Unity y configúralo para usar Firebase.

    • Si su proyecto de Unity ya usa Firebase, entonces ya está registrado y configurado para Firebase.

    • Si no tiene un proyecto de Unity, puede descargar una aplicación de muestra .

  • Agregue el SDK de Firebase Unity (específicamente, FirebaseRemoteConfig.unitypackage ) a su proyecto de Unity.

Tenga en cuenta que agregar Firebase a su proyecto de Unity implica tareas tanto en la consola de Firebase como en su proyecto de Unity abierto (por ejemplo, descarga archivos de configuración de Firebase desde la consola y luego los mueve a su proyecto de Unity).

Paso 2: establecer valores de parámetros predeterminados en la aplicación

Puede establecer valores de parámetros predeterminados en la aplicación en el objeto de Remote Config, para que su aplicación se comporte según lo previsto antes de conectarse al backend de Remote Config, y para que los valores predeterminados estén disponibles si no se establece ninguno en el backend.

Para hacer esto, cree un diccionario de cadenas y complételo con pares clave/valor que representen los valores predeterminados que desea agregar. Si ya configuró los valores de los parámetros del backend de Remote Config, puede descargar un archivo que contenga estos pares clave/valor y usarlo para construir su diccionario de cadenas. Para obtener más información, consulte Descargar los valores predeterminados de la plantilla de configuración remota .

(Las propiedades que no sean cadenas se convertirán al tipo de propiedad cuando se llame a SetDefaultsAsync() ).

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 => {

Paso 3: obtenga valores de parámetros para usar en su aplicación

Ahora puede obtener valores de parámetros del objeto Remote Config. Si establece valores en el backend de Remote Config, los recupera y luego los activa, esos valores están disponibles para su aplicación. De lo contrario, obtendrá los valores de los parámetros en la aplicación configurados mediante SetDefaultsAsync() .

Para obtener estos valores, use GetValue() y proporcione la clave del parámetro como argumento. Esto devuelve un ConfigValue , que tiene propiedades para convertir el valor en varios tipos base.

Paso 4: conecta tu aplicación en la consola de Firebase

En la consola de Firebase , agregue su aplicación a su proyecto de Firebase.

Paso 5: establecer los valores de los parámetros

  1. En la consola de Firebase , abre tu proyecto.
  2. Seleccione Configuración remota en el menú para ver el panel de configuración remota.
  3. Defina parámetros con los mismos nombres que los parámetros que definió en su aplicación. Para cada parámetro, puede establecer un valor predeterminado (que eventualmente anulará el valor predeterminado en la aplicación) y valores condicionales. Para obtener más información, consulte Parámetros y condiciones de Remote Config .

Paso 6: Obtener y activar valores (según sea necesario)

Para obtener valores de parámetros del backend de Remote Config, llama al método FetchAsync() . Todos los valores que establezca en el backend se recuperan y se almacenan en caché en el objeto de configuración remota.

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

Los valores obtenidos a través FetchAsync() se almacenan en caché localmente cuando se completa la recuperación, pero no están disponibles hasta que se invoca ActivateFetched() . Dado que FetchAsync() ejecuta de forma asincrónica, esto le permite asegurarse de que los nuevos valores no se apliquen a la mitad del cálculo o en otros momentos que puedan causar problemas o un comportamiento extraño.

Paso 7: (Opcional) Habilite el modo de desarrollador

Para habilitar el modo de desarrollador, que se puede usar para deshabilitar la limitación durante el desarrollo, puede usar la propiedad FirebaseRemoteConfig.Setting , configurando un nuevo ConfigSettings con IsDeveloperMode establecido en verdadero.

Next steps

If you haven't already, explore the Remote Config use cases , and take a look at some of the key concepts and advanced strategies documentation, including: