Firebase Remote Config 使用入门

iOS+ Android Web Flutter Unity C++

重要提示：本部分介绍了在移动和 Web 客户端上配置 Remote Config 的步骤。对于服务器环境，请参阅在服务器环境中使用 Remote Config。

您可以使用 Firebase Remote Config 来定义应用中的参数并在云端更新它们的值。这样，您无需更新应用即可修改应用的外观和行为。

Remote Config 库用于存储应用内默认参数值，从 Remote Config 后端中提取更新后的参数值，以及控制提取的值何时可供应用使用。如需了解详情，请参阅 Remote Config 加载策略。

本指南逐步介绍了入门步骤并提供了一些示例代码，所有这些代码都可以从 firebase/quickstart-unity GitHub 代码库中克隆或下载。

第 1 步：将 Remote Config 添加到您的应用

在使用 Remote Config 之前，您需要：

• 注册 Unity 项目并将其配置为使用 Firebase。

  • 如果您的 Unity 项目已在使用 Firebase，那么该项目已经注册并已配置为使用 Firebase。

  • 如果您没有 Unity 项目，则可以下载示例应用。

• 将 Firebase Unity SDK（具体而言是 FirebaseRemoteConfig.unitypackage）添加到您的 Unity 项目中。

如需了解这些初始设置任务的详细说明，请参阅将 Firebase 添加到您的 Unity 项目。

请注意，为了将 Firebase 添加到 Unity 项目，需要在 Firebase 控制台中和打开的 Unity 项目中执行若干任务（例如，从控制台下载 Firebase 配置文件，然后将配置文件移到 Unity 项目中）。

第 2 步：设置应用内默认参数值

您可以在 Remote Config 对象中设置应用内默认参数值，以便应用在连接到 Remote Config 后端之前能够按预期运行，并且保证在后端中未设置任何值时可以使用默认值。

重要提示：不要在 Remote Config 参数键或值中存储机密数据。Remote Config 数据在传输过程中会加密，但最终用户可以访问其客户端应用实例可用的任何默认或提取的 Remote Config 参数。

为实现上述目标，请创建一个新的字符串字典，并在其中填充一些键值对，以代表您要添加的默认参数值。如果您已配置 Remote Config 后端参数值，则可以下载包含这些键值对的文件，并使用该文件构建字符串字典。如需了解详情，请参阅下载 Remote Config 模板默认值。

（调用 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 => {

第 3 步：获取要在应用中使用的参数值

现在，您可以从 Remote Config 对象中获取参数值。如果您已在 Remote Config 后端中设置值，然后提取并激活它们，这些值便可供您的应用使用。否则，您将获得使用 SetDefaultsAsync() 配置的应用内参数值。

如需获取这些值，请调用 GetValue() 方法，并传入参数键作为调用的实参。这将返回一个 ConfigValue 对象，其中包含将值转换为各种基本类型的属性。

第 4 步：设置参数值

1. 在 Firebase 控制台中，打开您的项目。
2. 从菜单中选择 Remote Config，查看 Remote Config 信息中心。
3. 使用您在应用中指定的参数名称来定义参数。对于每个参数，您可以设置默认值（最终将替换应用内默认值）和条件值。如需了解详情，请参阅 Remote Config 参数和条件。

第 5 步：提取并激活值（根据需要）

如需从 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.DefaultInstance.FetchAsync(
      TimeSpan.Zero);
  return fetchTask.ContinueWithOnMainThread(FetchComplete);
}

在上面的代码中，FetchComplete 是一个方法，其签名与 ContinueWithOnMainThread() 的某个过载的参数相匹配。

在下面的示例代码中，系统会向 FetchComplete 方法传递前一个任务 (fetchTask)，以便 FetchComplete 确定它是否已完成。然后，此代码会使用 Info.LastFetchStatus 确定完成是否也成功。如果成功，系统会使用 ActivateAsync() 激活 Remote Config 参数值。

private void FetchComplete(Task fetchTask) {
  if (!fetchTask.IsCompleted) {
    Debug.LogError("Retrieval hasn't finished.");
    return;
  }

  var remoteConfig = FirebaseRemoteConfig.DefaultInstance;
  var info = remoteConfig.Info;
  if(info.LastFetchStatus != LastFetchStatus.Success) {
    Debug.LogError($"{nameof(FetchComplete)} was unsuccessful\n{nameof(info.LastFetchStatus)}: {info.LastFetchStatus}");
    return;
  }

  // Fetch successful. Parameter values must be activated to use.
  remoteConfig.ActivateAsync()
    .ContinueWithOnMainThread(
      task => {
        Debug.Log($"Remote data loaded and ready for use. Last fetch time {info.FetchTime}.");
    });
}

当提取操作完成后，使用 FetchAsync() 提取的值将缓存在本地，但直到调用 ActivateAsync() 之后才可使用。这可确保系统不会在计算过程中或在可能导致问题或异常行为的其他时间点应用新值。

第 6 步：实时监听更新

提取参数值后，您可以使用实时 Remote Config 监听 Remote Config 后端中的更新。有更新可用时，实时 Remote Config 会向关联设备发送信号，并会在有新的 Remote Config 版本发布后自动提取更改内容。

适用于 Android 和 Apple 平台的 Firebase Unity SDK v11.0.0 及更高版本支持实时更新。

重要提示：实时 Remote Config 还需要 Firebase Remote Config Realtime API，系统应该已经为您启用了该 API。如需确认该 API 已启用，请打开 Google Cloud 控制台，选择您的项目，然后打开 API 和服务页面。该 API 应显示为已启用。如果该 API 缺失或未启用，请点击启用 API 和服务，然后搜索 Firebase Remote Config Realtime API 并将其启用。

1. 在您的应用中，添加 OnConfigUpdateListener 以开始监听更新并自动提取任何新参数值或更新后的参数值。然后，创建一个 ConfigUpdateListenerEventHandler 来处理更新事件。以下示例会监听更新并使用新提取的值显示更新后的欢迎辞。

// Invoke the listener.
void Start()
{
  Firebase.RemoteConfig.FirebaseRemoteConfig.DefaultInstance.OnConfigUpdateListener
    += ConfigUpdateListenerEventHandler;
}

// Handle real-time Remote Config events.
void ConfigUpdateListenerEventHandler(
   object sender, Firebase.RemoteConfig.ConfigUpdateEventArgs args) {
  if (args.Error != Firebase.RemoteConfig.RemoteConfigError.None) {
    Debug.Log(String.Format("Error occurred while listening: {0}", args.Error));
    return;
  }

  Debug.Log("Updated keys: " + string.Join(", ", args.UpdatedKeys));
  // Activate all fetched values and then display a welcome message.
  remoteConfig.ActivateAsync().ContinueWithOnMainThread(
    task => {
        DisplayWelcomeMessage();
    });
}

// Stop the listener.
void OnDestroy() {
    Firebase.RemoteConfig.FirebaseRemoteConfig.DefaultInstance.OnConfigUpdateListener
      -= ConfigUpdateListenerEventHandler;
}

下次有新版本的 Remote Config 发布时，运行应用并监听更改的设备便会调用完成处理程序。

后续步骤

浏览 Remote Config 使用场景并查看一些关键的概念和高级策略文档（如果您尚未这样做），包括：

• 管理 Remote Config 模板版本
• 配置加载策略