開始使用 Firebase 遠端設定

iOS+ Android 網頁版 Flutter Unity C++

重要事項： 本節說明如何設定 Remote Config 與行動和網頁用戶端。如需伺服器環境的相關資訊，請參閱「在伺服器環境中使用 Remote Config」一文。

您可以使用 Firebase 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 版本後自動擷取變更。

Firebase Unity SDK 11.0.0 以上版本支援 Android 和 Apple 平台的即時更新功能。

重要事項：即時 Remote Config 也需要 Firebase Remote Config Realtime API，而您應該已啟用該 API。如要確認，請開啟 Google Cloud 控制台，選取專案，然後開啟「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 範本版本
• 設定載入策略