遠端設定參數和條件

您可以為用戶端和伺服器用途設定範本。客戶 範本會向任何導入 Firebase 的應用程式執行個體提供 Remote Config 的用戶端 SDK，包括 Android、Apple、Web、Unity Flutter 和 C++ 應用程式Remote Config 個參數和值的來源 伺服器專用範本提供給 Remote Config 實作 (包括 Cloud Run 和 Cloud Functions) 使用 Firebase 管理員 Node.js SDK v12.1.0 以上版本。

使用 Firebase 控制台或 Remote Config 個後端 API 您可以定義一或多個參數 )，並為這些參數提供應用程式內預設值。您可覆寫 定義相關的應用程式內預設值 參數鍵和參數值是字串，但 當您在

您可以使用 Firebase 控制台、Admin SDK 或 Remote Config REST API，為參數建立新的預設值，以及用於指定應用程式執行個體群組的條件值。每次在 Firebase 控制台中更新設定時， Firebase 會建立並發布新版 Remote Config 範本。 系統會儲存先前的版本，讓您視需要擷取或復原。您可以在 Firebase 控制台中使用這些作業 Firebase Admin SDK 和 REST API 等 管理 Remote Config 個範本版本。

本指南說明參數、條件、規則、條件 值，以及系統如何決定各參數值的優先順序 Remote Config 伺服器和應用程式。也會詳細說明 用來建立條件的規則

條件、規則和條件值

條件可用於指定一組應用程式執行個體。條件生效 一或多個規則，這些規則必須全部評估為 true，才符合條件 指定應用程式例項的 true。如果規則值是 未定義 (例如沒有可用的值時)，該規則會評估為 false。

舉例來說，定義應用程式啟動畫面的參數可使用規則 if device_os = Android，根據 OS 類型顯示不同的圖片：

或者，您也可以使用時間條件來控管應用程式顯示特別促銷商品的時間。

一個參數中可以有多個條件 套用不同條件的值，而且參數可以在 專案。在「Parameters」分頁 Firebase控制台中，您可以查看每個專案的擷取百分比 參數的條件值這項指標會顯示過去 24 小時內收到各個值的要求百分比。

參數值優先順序

一個參數可能有多個相關聯的條件值。下列規則會決定從 Remote Config 伺服器擷取哪個值，以及在特定時間點，在特定應用程式執行個體中使用哪個值：

系統會根據下列優先順序擷取參數值 清單

1. 第一，如果系統有評估條件時，會套用條件式值 特定應用程式執行個體的 true 要求。如果多項條件的評估結果為 true， 系統會優先採用 Firebase 控制台 UI 中顯示的第一個 (頂端) 路徑，以及 系統會在應用程式提供與該條件相關聯的條件式值時 從後端擷取值。如要變更條件的優先順序， 在「Conditions」(條件) 分頁中拖曳條件。

2. 如果沒有任何條件值的條件會評估為 true，則在應用程式從後端擷取值時，系統會提供 Remote Config 的預設值。如果後端不存在參數，或是預設值設為「使用應用程式內預設值」，則應用程式擷取值時，系統不會為該參數提供任何值。

在應用程式中，get 方法會根據以下優先順序清單傳回參數值

1. 如果值已從後端擷取，然後啟用，應用程式會使用 擷取的值。已啟用的參數值為永久性。

2. 如果系統未從後端擷取任何值，或是系統從 Remote Config 後端尚未啟用，該應用程式會使用應用程式內資料 預設值。

   如要進一步瞭解如何取得及設定預設值，請參閱 下載 Remote Config 範本預設值。

3. 如未設定應用程式內預設值，應用程式會使用靜態類型 值 (例如 int 為 0，boolean 為 false)。

下圖概略說明 Remote Config 後端和應用程式中參數值的優先順序：

參數值資料類型

Remote Config 可讓您為每項參數選取資料類型，且 建立範本前，依據該類型驗證所有 Remote Config 值 更新。資料類型在 getRemoteConfig 上儲存及傳回 請求。

支援的資料類型包括：

• String
• Boolean
• Number
• JSON

在 Firebase 控制台 UI 中，您可以從下列位置選取資料類型： 下拉式選單。在 REST API 中，您可以使用參數物件中的 value_type 欄位設定類型。

參數群組

Remote Config 可讓你將參數分組，使參數更井然有序 使用者介面，提高可用性。

舉例來說，假設您需要啟用或停用三種驗證類型 新的登入功能Remote Config 可讓您建立 讓您啟用所需類型並整理成 「新登入」群組不必加入前置字元或特殊排序

您可以使用 Firebase 控制台或 Remote Config REST API。您建立的每個參數群組在 您的 Remote Config 範本。建立參數群組時，請注意下列事項：

• 參數只能在任何時間加入一個群組，且參數金鑰在所有參數中仍須保持不重複。
• 參數群組名稱的長度上限為 256 個半形字元。
• 如果您同時使用 REST API 和 Firebase 控制台，請確認所有 REST API 邏輯已更新，可在發布時處理參數群組。

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

您可以將參數分組 的「Parameters」分頁 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 pumpkin spice season."
        }
      }
    }
  }
}

條件規則類型

Firebase 控制台支援下列規則類型。對等 Remote Config REST API 會提供功能，詳情請參閱 條件運算式參考資料。

搜尋參數和條件

您可以搜尋專案的參數鍵、參數值和條件 使用 Firebase 控制台，使用 「參數」分頁頂端的搜尋框。Remote Config

參數和條件的限制

一項 Firebase 專案中最多可以有 2,000 個參數和 500 個 條件。參數鍵長度上限為 256 個字元，且必須以 底線或英文字母字元 (A-Z、a-z)，也可以包含 數字。專案中參數值字串的總長度不得 超過 1,000,000 個字元

查看參數和條件的異動

你可以查看Remote Config範本的最新變更 請點選 Firebase 控制台。適用對象 您可以執行以下操作：

• 查看上次修改參數或條件的使用者名稱。

• 如果變更發生在同一天內，即可查看幾分鐘或 從變更發布至有效運作中狀態經過時數 Remote Config範本。

• 如果變更發生在過去一或多天，請查看變更發布至有效 Remote Config 範本的日期。

參數更新

在 Remote Config「參數」中 「上次發布時間」欄則會顯示上次修改新版本的使用者人數 參數和上次發布日期：

• 如要查看已分組參數的變更中繼資料，請展開參數群組。

• 如要依發布日期遞增或遞減排序，請按一下 「上次發布時間」欄標籤。

狀況更新

Remote Config 「條件」頁面，可以 可查看上次修改條件的使用者和修改日期 。

後續步驟

如要開始設定 Firebase 專案，請參閱 設定 Firebase Remote Config 專案。