Cómo comenzar con Firebase Remote Config para Unity

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

La biblioteca de Remote Config se usa para almacenar los valores de parámetros predeterminados dentro de la app, obtener los valores de parámetros actualizados desde el servicio y controlar cuándo están disponibles los valores obtenidos para tu app. Para obtener más información, consulta la descripción general de la API de Remote Config.

Cómo agregar Remote Config a tu app

Para poder usar Firebase Remote Config, debes crear un proyecto de Firebase y agregar los paquetes del SDK de Firebase Unity a tu proyecto de Unity.

Configuración:

Requisitos previos

Android

  • Unity 5.0 o una versión más reciente
  • NDK de Android 10d o una versión más reciente

iOS

  • Unity 5.0 o una versión más reciente
  • Xcode 7.0 o una versión más reciente

Si todavía no tienes un proyecto de Unity, puedes descargar una de nuestras guías de inicio rápido de muestra para probar una función de Firebase específica. Si usas un inicio rápido, recuerda obtener el identificador del paquete de la configuración del proyecto, ya que lo necesitarás en el paso siguiente.

Configura tu app en Firebase console

Para agregar Firebase a tu app, debes tener un proyecto y un archivo de configuración de Firebase para ella.

Crea un proyecto en Firebase console si no lo hiciste antes. Si ya tienes un proyecto de Google asociado con tu app para dispositivos móviles, haz clic en Importar proyecto de Google. De lo contrario, haz clic en Crear proyecto nuevo.

Android

  1. Haz clic en Agrega Firebase a tu app para Android y sigue los pasos de la configuración. Si estás importando un proyecto de Google existente, es posible que esto suceda de forma automática y solo tengas que descargar el archivo de configuración.
  2. Ingresa el nombre del paquete de la app cuando se te solicite. Es importante que ingreses el nombre del paquete que usa tu app. Esto solo se puede configurar cuando agregas una app a tu proyecto de Firebase.
  3. Descarga un archivo google-services.json cuando se te indique. Puedes volver a descargar este archivo en cualquier momento.
  4. Copia este archivo en cualquier ubicación de la carpeta de elementos de tu proyecto.

iOS

  1. Haz clic en Agrega Firebase a tu app para iOS y sigue los pasos para ajustar la configuración. Si estás importando un proyecto de Google existente, es posible que esto suceda de forma automática y solo tengas que descargar el archivo de configuración.
  2. Ingresa el ID del paquete de la app cuando se te solicite. Es importante que ingreses el ID del paquete que usa tu app. Esto solo se puede configurar cuando agregas una app a tu proyecto de Firebase.
  3. Descarga un archivo GoogleService-Info.plist cuando se te indique. Puedes volver a descargar este archivo en cualquier momento.
  4. Agrega el archivo GoogleService-Info.plist al proyecto.

  5. Arrastra el GoogleService-Info.plist que descargaste de Firebase console a cualquier carpeta del proyecto de Unity.

Agrega el SDK de Firebase Unity a tu app

  1. Descarga el SDK de Firebase Unity.
  2. Selecciona el elemento de menú Assets > Import Package > Custom Package.
  3. Importa el paquete FirebaseRemoteConfig.unitypackage del SDK de Firebase Unity, que descargaste previamente.
  4. Cuando aparezca la ventana Import Unity Package, haz clic en el botón Import.

Compila tu app

Android

  1. Selecciona la opción de menú File > Build Settings.
  2. Selecciona Android en la lista Platform.
  3. Haz clic en Switch Platform para elegir Android como plataforma seleccionada.
  4. Espera hasta que se detenga el ícono giratorio (de compilación en proceso), que se encuentra en la esquina inferior derecha de la barra de estado de Unity.
  5. Haz clic en Build and Run.

iOS

  1. Selecciona la opción de menú File > Build Settings.
  2. Selecciona iOS en la lista Platform.
  3. Haz clic en Switch Platform para elegir iOS como plataforma seleccionada.
  4. Espera hasta que se detenga el ícono giratorio (de compilación en proceso), que se encuentra en la esquina inferior derecha de la barra de estado de Unity.
  5. Haz clic en Build and Run.

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 servicio. Esto permite que tu app se comporte de la manera prevista antes de que se conecte con el servicio 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 al tipo de la 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
// service yet, or if we ask for values that the service 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);

Cómo obtener los valores de parámetros para usar en tu app

Ahora puedes obtener los valores de parámetros desde el objeto Remote Config. Si estableciste valores en el servicio de Remote Config, los recuperaste y los activaste, esos valores están disponibles para tu app. De lo contrario, obtienes los valores de parámetro configurados dentro de la aplicación con 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 a varios tipos base.

Conecta tu app en Firebase console

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

Configura los valores de parámetro en el servicio (según sea necesario)

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

Obtén y activa valores desde el servicio (según sea necesario)

Para obtener valores de parámetro desde el servicio de Remote Config, llama al método FetchAsync(). Cualquier valor que configures en el servidor de Remote Config se obtiene y se almacena 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 estará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

Para habilitar el modo de programador, que se puede usar para inhabilitar la regulación durante el desarrollo, puedes usar la propiedad FirebaseRemoteConfig.Setting y configurar una nueva ConfigSettings con el valor "verdadero" para IsDeveloperMode.

Enviar comentarios sobre…

¿Necesitas ayuda? Visita nuestra página de asistencia.