遠程配置參數和條件

使用 Firebase 控制台或Remote Config 後端 API時，您可以定義一個或多個參數（鍵值對）並為這些參數提供應用內默認值。您可以通過定義服務器端參數值來覆蓋應用內默認值。參數鍵和參數值是字符串，但是當您在應用程序中使用這些值時，參數值可以轉換為其他數據類型。

使用 Firebase 控制台或Remote Config REST API ，您可以為參數創建新的默認值，以及用於定位應用實例組的條件值。每次您在 Firebase 控制台中更新配置時，Firebase 都會創建並發布新版本的遠程配置模板。以前的版本被存儲，允許您根據需要檢索或回滾。您也可以通過 REST API 使用這些操作。

本指南解釋了參數、條件、規則、條件值，以及各種參數值在遠程配置服務器和您的應用程序中的優先級。它還提供了有關用於創建條件的規則類型的詳細信息。

條件、規則和條件值

條件用於定位一組應用程序實例。條件由一個或多個規則組成，對於給定的應用程序實例，這些規則必須全部計算為true ，條件才能計算為true 。如果規則的值未定義（例如，當沒有可用值時），則該規則將評估為false 。

例如，定義應用啟動頁面的參數可以使用簡單規則if device_os = Android根據操作系統類型顯示不同的圖像：

或者，可以使用時間條件來控制您的應用何時顯示特殊促銷項目。

一個參數可以有多個使用不同條件的條件值，並且參數可以在項目內共享條件。在 Firebase 控制台的“參數”選項卡中，您可以查看每個參數的條件值的獲取百分比。該指標表示過去 24 小時內收到每個值的請求的百分比。

參數值優先級

一個參數可能有幾個與之關聯的條件值。以下規則確定從遠程配置服務器獲取哪個值，以及在特定時間點在給定應用程序實例中使用哪個值：

服務端參數值根據以下優先級列表獲取

1. 首先，應用條件值，如果有條件對於給定的應用程序實例評估為true 。如果多個條件的計算結果為true ，則 Firebase 控制台 UI 中顯示的第一個（頂部）具有優先權，並且在應用從後端獲取值時提供與該條件關聯的條件值。您可以通過在條件選項卡中拖放條件來更改條件的優先級。

2. 如果沒有條件值為true的條件值，則在應用程序從後端獲取值時提供服務器端默認值。如果後端不存在參數，或者默認值設置為Use in-app default ，則在應用獲取值時不會為該參數提供任何值。

在您的應用程序中，參數值由get方法根據以下優先級列表返回

1. 如果從後端獲取值然後激活，則應用程序使用獲取的值。激活的參數值是持久的。

2. 如果沒有從後端獲取值，或者從遠程配置後端獲取的值尚未激活，則應用使用應用內默認值。

   有關獲取和設置默認值的更多信息，請參閱下載遠程配置模板默認值。

3. 如果未設置應用內默認值，則應用使用靜態類型值（例如0代表int ， false代表boolean ）。

此圖總結了遠程配置後端和您的應用程序中參數值的優先級：

參數值數據類型

遠程配置允許您為每個參數選擇一種數據類型，並在模板更新之前根據該類型驗證所有服務器端值。數據類型在getRemoteConfig請求中存儲和返回。

目前支持的類型有：

• String
• Boolean
• Number
• JSON

在 Firebase 控制台 UI 中，可以從參數鍵旁邊的下拉菜單中選擇數據類型。在 REST API 中，可以使用參數對像中的value_type字段來設置類型。

參數組

遠程配置允許您將參數組合在一起，以獲得更有條理的 UI 和心理模型。

例如，假設您在推出新的登錄功能時需要啟用或禁用三種不同的身份驗證類型。使用遠程配置，您可以創建三個參數以根據需要啟用類型，然後將它們組織在一個名為“新登錄”的組中，無需添加前綴或特殊排序。

您可以使用 Firebase 控制台或 Remote Config REST API 創建參數組。您創建的每個參數組在遠程配置模板中都有一個唯一的名稱。創建參數組時，請記住：

• 參數在任何時候只能包含在一個組中，並且參數鍵在所有參數中仍然必須是唯一的。
• 參數組名稱限制為 256 個字符。
• 如果您同時使用 REST API 和 Firebase 控制台，請確保更新任何 REST API 邏輯以處理髮佈時的參數組。

使用 Firebase 控制台創建或修改參數組

您可以在 Firebase 控制台的“參數”選項卡中對參數進行分組。創建或修改組：

1. 選擇管理組。
2. 選擇要添加的參數的複選框，然後選擇移動到組。
3. 選擇現有組，或通過輸入名稱和描述並選擇創建新組來創建新組。保存組後，可以使用發布更改按鈕進行發布。

以編程方式創建組

Remote Config REST API提供了一種自動創建和發布參數組的方法。假設您熟悉 REST 並設置為授權對 API 的請求，您可以執行以下步驟以編程方式管理組：

1. 檢索當前模板
2. 添加 JSON 對像以表示您的參數組
3. 使用 HTTP PUT 請求發布參數組。

parameterGroups對象包含組鍵、嵌套描述和分組參數列表。請注意，每個組鍵必須是全局唯一的。

例如，以下是模板修訂版的摘錄，該修訂版添加了帶有一個參數的參數組“新菜單”， pumpkin_spice_season ：

{
  "parameters": {},
  "version": {
    "versionNumber": "1",

    …


  },
  "parameterGroups": {
    "new menu": {
      "description": "New Menu",
      "parameters": {
        "pumpkin_spice_season": {
          "defaultValue": {
            "value": "true"
          },
          "description": "Whether it's currently pumpkin spice season."
        }
      }
    }
  }
}

條件規則類型

Firebase 控制台支持以下規則類型。 Remote Config REST API 中提供了等效功能，詳見條件表達式參考。

搜索參數和條件

您可以使用遠程配置參數選項卡頂部的搜索框從Firebase 控制台搜索項目的參數鍵、參數值和條件。

參數和條件的限制

在一個 Firebase 項目中，您最多可以有 2000 個參數和最多 500 個條件。參數鍵最長可達 256 個字符，必須以下劃線或英文字母字符（AZ、az）開頭，還可以包含數字。項目中參數值字符串的總長度不能超過 1,000,000 個字符。

下一步

要開始配置您的 Firebase 項目，請參閱設置 Firebase 遠程配置項目。