Ir para o console

Primeiros passos com o Configuração remota do Firebase para Unity

Você pode usar o Firebase Configuração remota para definir parâmetros no app e atualizar os valores dele na nuvem, o que permite que você modifique a aparência e o comportamento do seu app sem distribuir uma atualização dele.

A biblioteca do Configuração remota é usada para armazenar valores padrão de parâmetros dentro do app, buscar valores atualizados de parâmetros do serviço e controlar quando os valores buscados são disponibilizados ao app. Para saber mais, consulte Visão geral da Remote Config API.

Adicionar o Configuração remota ao seu app

Antes de usar o Configuração remota, você precisa fazer o seguinte:

  • registrar seu projeto do Unity e configurá-lo para usar o Firebase.

    • Se o projeto do Unity já usa o Firebase, ele já está registrado e configurado para o Firebase.

    • Se você não tiver um projeto do Unity, poderá fazer o download de um aplicativo de amostra.

  • adicionar o SDK para Unity do Firebase (especificamente, FirebaseRemoteConfig.unitypackage) ao seu projeto do Unity.

A adição do Firebase ao seu projeto do Unity envolve tarefas no Console do Firebase e no projeto do Unity aberto (por exemplo, você faz o download dos arquivos de configuração do Firebase no console e os move para o projeto do Unity).

Definir valores padrão de parâmetros dentro do app

Você pode definir valores padrão de parâmetros no objeto do Configuração remota, para serem usados se nenhum outro valor tiver sido recuperado a partir do serviço. Isso permite que seu app se comporte da maneira pretendida antes de se conectar ao serviço do Configuração remota.

Para fazer isso, crie um dicionário de strings e preencha-o com pares de chave-valor que representam os padrões que você quer adicionar. (Propriedades sem string serão convertidas no tipo de propriedade quando SetDefaults for chamado).

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

Receber valores de parâmetros para uso no app

Agora, é possível receber valores de parâmetros do objeto do Configuração remota. Se você definiu valores no serviço do Configuração remota, recuperou esses valores e os ativou, eles estarão disponíveis no app. Caso contrário, você recebe os valores de parâmetros no app configurados usando SetDefaults().

Para receber esses valores, use GetValue(), fornecendo a chave de parâmetro como argumento. Isso retorna um ConfigValue, que tem propriedades para converter o valor em vários tipos de base.

Conectar o app ao Console do Firebase

No Console do Firebase, adicione seu app ao projeto do Firebase.

Definir valores de parâmetro no serviço (conforme necessário)

  1. No Firebase console, abra seu projeto.
  2. Selecione Configuração remota no menu para ver o painel.
  3. Defina os parâmetros com os mesmos nomes dos que você definiu no app. Para cada parâmetro, você pode definir um valor padrão (que no final modificará o valor padrão dentro do app) e os valores condicionais. Para saber mais, consulte Parâmetros e condições do Configuração remota.

Recuperar e ativar valores do serviço (conforme necessário)

Para recuperar os valores de parâmetro do serviço Configuração remota, chame o método FetchAsync(). Todos os valores definidos no serviço são recuperados e armazenados em cache no objeto.

Os valores recuperados por meio de FetchAsync() são armazenados em cache localmente no final da operação, mas não são disponibilizados até que ActivateFetched() seja chamado. Como FetchAsync() é executado de modo assíncrono, os novos valores não são aplicados durante o cálculo ou em ocasiões que podem resultar em problemas ou comportamentos estranhos.

(Opcional) Ativar modo do desenvolvedor

Para ativar o modo de desenvolvedor, que pode usado para desativar o controle de fluxo durante o desenvolvimento, use a propriedade FirebaseRemoteConfig.Setting definindo um novo ConfigSettings com IsDeveloperMode definido como verdadeiro.