Ir a la consola

Primeros pasos con Firebase Remote Config para Unity

Puedes usar Firebase Remote Config para definir parámetros en tu app y actualizar sus valores en la nube, lo que te permite modificar el aspecto y el comportamiento de la app sin distribuir una actualización de ella.

La biblioteca de Remote Config se usa para almacenar los valores de parámetros predeterminados en la app, recuperar valores de parámetros actualizados del backend de Remote Config y controlar cuándo están disponibles los valores obtenidos para la app. Para obtener más información, consulta las estrategias de carga de Remote Config.

Agrega Remote Config a la app

Sigue estos pasos antes de empezar a usar Remote Config:

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

    • Si tu proyecto de Unity ya usa Firebase, significa que ya está registrado y configurado para Firebase.

    • Si aún no tienes un proyecto de Unity, puedes descargar una app de muestra.

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

Ten en cuenta que agregar Firebase a tu proyecto de Unity implica realizar tareas en Firebase console y en tu proyecto abierto de Unity (por ejemplo, descargar archivos de configuración de Firebase desde la consola y moverlos a tu proyecto de Unity).

Configura los valores de parámetros predeterminados en la app

Puedes establecer valores de parámetros predeterminados en el objeto de Remote Config para usarlo si no se recuperan otros valores del backend. Esto permite que tu app se comporte según lo previsto antes de que se conecte al backend de Remote Config.

Para esto, crea un diccionario de strings y llénalo con pares clave-valor que representen los valores predeterminados que deseas agregar. Las propiedades que no sean strings se convertirán en el tipo de propiedad cuando se llame a SetDefaults.

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
// backend yet, or if we ask for values that the backend 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);

Obtén los valores de parámetros para usar en la app

Ahora puedes obtener valores de parámetros desde el objeto de Remote Config. Si configuras valores en el backend de Remote Config, los recuperas y los activas, esos valores estarán disponibles para tu app. De lo contrario, obtendrás los valores de parámetros configurados en la app mediante SetDefaults().

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

Conecta la app en Firebase console

En Firebase console, agrega tu app al proyecto de Firebase.

Configura los valores de parámetros

  1. Abre el proyecto en Firebase console.
  2. Selecciona Remote Config desde el menú para ver el panel de control de Remote Config.
  3. Define parámetros que tengan los mismos nombres que los que definiste en tu app. Para cada parámetro, puedes definir un valor predeterminado (que, en última instancia, anulará el valor predeterminado de la app) y valores condicionales. Para obtener más información, consulta los parámetros y condiciones de Remote Config.

Recupera y activa valores (cuando corresponda)

Para recuperar valores de los parámetros del backend de Remote Config, llama al método FetchAsync(). Todos los valores que estableces en el backend se recuperan y almacenan en caché en el objeto de Remote Config.

Los valores obtenidos a través de FetchAsync() se almacenan en caché de manera local cuando termina la recuperación, pero no están disponibles hasta que se invoque ActivateFetched(). Dado que FetchAsync() se ejecuta de forma asíncrona, puedes estar seguro de que los valores nuevos no se aplican en medio del cálculo ni en otro momento que pueda causar problemas o un comportamiento extraño.

(Opcional) Habilita el modo de programador

A fin de habilitar el modo de desarrollador, que se puede usar para inhabilitar la regulación durante el desarrollo, puedes usar la propiedad FirebaseRemoteConfig.Setting, lo que establecerá una ConfigSettings nueva con IsDeveloperMode configurado como true.