Firebase 远程配置使用入门 (Unity)

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

远程配置库用于存储应用内默认参数值，从服务中提取更新后的参数值，以及控制提取的值是否可用于您的应用。如需了解详情，请参阅 Remote Config API 概览。

将远程配置添加至您的应用

您必须先创建一个 Firebase 项目，并将 Firebase Unity SDK 包添加到您的 Unity 项目中，然后才能使用 Firebase 远程配置。

设置：

前提条件

Android

  • Unity 5.0 或更高版本
  • Android NDK 版本 10d 或更高版本

iOS

  • Unity 5.0 或更高版本
  • Xcode 7.0 或更高版本

如果您还没有 Unity 项目，可以下载我们的某个快速入门示例，试用一下特定的 Firebase 功能。如果使用快速入门示例，请不要忘记从项目设置中获取软件包标识符，下一步中会用到该标识符。

在 Firebase 控制台中设置您的应用

要将 Firebase 添加到您的应用，您需要有一个 Firebase 项目以及适用于您的应用的 Firebase 配置文件。

如果您还没有 Firebase 项目，请在 Firebase 控制台中创建一个。如果您已经有与自己的移动应用相关联的现有 Google 项目，请点击导入 Google 项目。如果没有，请点击添加项目。

Android

  1. 点击将 Firebase 添加到您的 Android 应用，然后按设置步骤操作。如果您是导入现有 Google 项目，系统可能会自动执行这些操作，您只需下载配置文件即可。
  2. 出现提示时，输入应用的软件包名称。请务必输入应用在使用的软件包名称；只有在将应用添加到 Firebase 项目时您才能进行此设置。
  3. 按照说明下载 google-services.json 文件。您随时可以再重新下载此文件。
  4. 将此文件复制到项目的资源文件夹内的任意位置。

iOS

  1. 点击将 Firebase 添加到您的 iOS 应用，然后按设置步骤操作。如果您是导入现有 Google 项目，系统可能会自动执行这些操作，您只需下载配置文件即可。
  2. 出现提示时，输入应用的软件包 ID。请务必输入应用在使用的软件包 ID；只有在将应用添加到 Firebase 项目时您才能进行此设置。
  3. 按照说明下载 GoogleService-Info.plist 文件。您随时可以再重新下载此文件。

  4. 将 GoogleService-Info.plist 文件添加到项目中。

    • 将从 Firebase 控制台下载的 GoogleService-Info.plist 拖动到 Unity 项目中的任意文件夹内。

将 Firebase Unity SDK 添加到您的应用

  1. 下载 Firebase Unity SDK。
  2. 选择“Assets > Import Package > Custom Package”菜单项。
  3. 从之前下载的 Firebase Unity SDK 导入 FirebaseRemoteConfig.unitypackage 软件包。
  4. 当出现 Import Unity Package 窗口时，点击 Import 按钮。

编译您的应用

Android

  1. 依次选择 File > Build Settings 菜单选项。
  2. 选择 Platform 列表中的 Android。
  3. 点击 Switch Platform，选择 Android 作为目标平台。
  4. 等待 Unity 状态栏右下角的旋转进度条（正在编译）图标停止旋转。
  5. 点击 Build and Run。

iOS

  1. 依次选择 File > Build Settings 菜单选项。
  2. 选择 Platform 列表中的 iOS。
  3. 点击 Switch Platform，选择 iOS 作为目标平台。
  4. 等待 Unity 状态栏右下角的旋转进度条（正在编译）图标停止旋转。

  5. 点击 Build and Run。

设置应用内默认参数值

您可以在远程配置对象中设置应用内默认参数值，使您的应用可以在未从服务中检索到任何值时使用默认值。同时，使您的应用在连接至远程配置服务之前可以按预期工作。

为实现上述目标，请创建一个新的字符串字典，并在其中填充一些键值对，以代表您要添加的默认参数值。（当调用 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);

获取要在应用中使用的参数值

现在，您可以从远程配置对象中获取参数值。若您在远程配置服务中设置、提取并激活了值，这些值便可以供您的应用使用。否则，您需要获取使用 setDefaults() 配置的应用内参数值。

要获取这些值，请使用 GetValue()，以参数形式提供参数键。这将返回一个 ConfigValue，其中包含将值转换为各种基类型的属性。

在 Firebase 控制台中关联您的应用

在 Firebase 控制台中，将您的应用添加到您的 Firebase 项目。

在服务中设置参数值（若需要）

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

从服务中提取和激活值（若需要）

要从远程配置服务提取参数值，请调用 FetchAsync() 方法。系统将提取您在远程配置服务器上设置的所有值，并缓存在远程配置对象中。

当提取操作完成后，通过 FetchAsync() 提取的值将缓存在本地，但直到调用 ActivateFetched() 之后才可使用。由于 FetchAsync() 是异步执行的，因此可确保系统不会在计算过程中或在可能导致问题或奇怪行为的其他时间点激活新的值。

（可选）启用开发者模式

要启用开发者模式（可用于在开发过程中停用相关限制），您可以使用 FirebaseRemoteConfig.Setting 属性设置一个新的 ConfigSettings，并将 IsDeveloperMode 设置为 true。

发送以下问题的反馈：

此网页
文档反馈
Firebase
Firebase
产品反馈
需要帮助？请访问我们的支持页面。