Trang này được dịch bởi Cloud Translation API.

Bắt đầu sử dụng Cấu hình từ xa Firebase

Bạn có thể dùng Firebase Remote Config để xác định các tham số trong ứng dụng và cập nhật giá trị của các tham số đó trên đám mây, cho phép bạn sửa đổi giao diện và hành vi của ứng dụng mà không cần phân phối bản cập nhật ứng dụng.

Thư viện Remote Config được dùng để lưu trữ các giá trị tham số mặc định trong ứng dụng, tìm nạp các giá trị tham số đã cập nhật từ phần phụ trợ Remote Config và kiểm soát thời điểm cung cấp các giá trị đã tìm nạp cho ứng dụng của bạn. Để tìm hiểu thêm, hãy xem Các chiến lược tải Cấu hình từ xa.

Hướng dẫn này sẽ hướng dẫn bạn các bước để bắt đầu và cung cấp một số mã mẫu. Bạn có thể sao chép hoặc tải tất cả mã mẫu này xuống từ kho lưu trữ firebase/quickstart-unity trên GitHub.

Bước 1: Thêm Remote Config vào ứng dụng

Để có thể sử dụng Remote Config, bạn cần phải:

Đăng ký dự án Unity và định cấu hình dự án đó để sử dụng Firebase.
- Nếu dự án Unity của bạn đã sử dụng Firebase, thì dự án đó đã được đăng ký và định cấu hình cho Firebase.
- Nếu chưa có dự án Unity, bạn có thể tải ứng dụng mẫu xuống.
Thêm Firebase Unity SDK (cụ thể là FirebaseRemoteConfig.unitypackage) vào dự án Unity của bạn.

Xin lưu ý rằng việc thêm Firebase vào dự án Unity của bạn bao gồm các thao tác cả trong bảng điều khiển Firebase và trong dự án Unity đang mở của bạn (ví dụ: bạn tải tệp cấu hình Firebase xuống từ bảng điều khiển, sau đó di chuyển các tệp đó vào dự án Unity).

Bước 2: Đặt giá trị tham số mặc định trong ứng dụng

Bạn có thể đặt các giá trị tham số mặc định trong ứng dụng trong đối tượng Remote Config để ứng dụng của bạn hoạt động như dự kiến trước khi kết nối với phần phụ trợ Remote Config và để các giá trị mặc định có sẵn nếu không có giá trị nào được đặt trong phần phụ trợ.

Để làm việc này, hãy tạo một từ điển chuỗi và điền vào đó các cặp khoá/giá trị đại diện cho các giá trị mặc định mà bạn muốn thêm. Nếu đã định cấu hình các giá trị tham số phụ trợ Remote Config, bạn có thể tải một tệp chứa các cặp khoá/giá trị này xuống và dùng tệp đó để tạo từ điển chuỗi. Để biết thêm thông tin, hãy xem phần Tải mẫu Remote Config mặc định xuống.

(Các thuộc tính không phải chuỗi sẽ được chuyển đổi thành loại thuộc tính khi SetDefaultsAsync() được gọi).

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 => {

Bước 3: Nhận giá trị thông số để sử dụng trong ứng dụng

Giờ đây, bạn có thể lấy các giá trị tham số từ đối tượng Remote Config. Nếu bạn đặt các giá trị trong phần phụ trợ Remote Config, tìm nạp các giá trị đó rồi kích hoạt chúng, thì ứng dụng của bạn có thể sử dụng các giá trị đó. Nếu không, bạn sẽ nhận được các giá trị tham số trong ứng dụng được định cấu hình bằng SetDefaultsAsync().

Để nhận các giá trị này, hãy dùng GetValue(), cung cấp khoá tham số làm đối số. Thao tác này trả về ConfigValue, có các thuộc tính để chuyển đổi giá trị thành nhiều loại cơ sở.

Bước 4: Đặt giá trị tham số

Trong bảng điều khiển Firebase, hãy mở dự án của bạn.
Chọn biểu tượng Remote Config trong trình đơn để xem trang tổng quan Remote Config.
Xác định các thông số có cùng tên với các thông số mà bạn đã xác định trong ứng dụng. Đối với mỗi thông số, bạn có thể đặt một giá trị mặc định (cuối cùng sẽ ghi đè giá trị mặc định trong ứng dụng) và các giá trị có điều kiện. Để tìm hiểu thêm, hãy xem các thông số và điều kiện Remote Config.

Bước 5: Tìm nạp và kích hoạt các giá trị (nếu cần)

Để tìm nạp các giá trị tham số từ phần phụ trợ Remote Config, hãy gọi phương thức FetchAsync(). Mọi giá trị mà bạn đặt trên phần phụ trợ đều được tìm nạp và lưu vào bộ nhớ đệm trong đối tượng 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);
}

Trong mã ở trên, FetchComplete là một phương thức có chữ ký khớp với các tham số của một trong các nạp chồng của ContinueWithOnMainThread().

Trong mã mẫu bên dưới, phương thức FetchComplete được truyền vào tác vụ trước đó (fetchTask), cho phép FetchComplete xác định xem tác vụ đó đã hoàn tất hay chưa. Mã này sử dụng Info.LastFetchStatus để xác định xem quá trình kết thúc có cũng thành công hay không. Nếu có, các giá trị tham số Remote Config sẽ được kích hoạt bằng cách sử dụng ActivateAsync().

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}.");
    });
}

Các giá trị được tìm nạp bằng FetchAsync() sẽ được lưu vào bộ nhớ đệm cục bộ khi quá trình tìm nạp hoàn tất, nhưng sẽ không có sẵn cho đến khi ActivateAsync() được gọi. Điều này giúp bạn đảm bảo rằng các giá trị mới không được áp dụng trong quá trình tính toán hoặc vào những thời điểm khác có thể gây ra vấn đề hoặc hành vi bất thường.

Bước 6: Nghe thông tin cập nhật theo thời gian thực

Sau khi tìm nạp các giá trị tham số, bạn có thể sử dụng Remote Config theo thời gian thực để theo dõi thông tin cập nhật từ phần phụ trợ Remote Config. Tín hiệu Remote Config theo thời gian thực cho các thiết bị được kết nối khi có bản cập nhật và tự động tìm nạp các thay đổi sau khi bạn xuất bản một phiên bản Remote Config mới.

SDK Firebase Unity phiên bản 11.0.0 trở lên hỗ trợ tính năng cập nhật theo thời gian thực cho các nền tảng Android và Apple.

Trong ứng dụng của bạn, hãy thêm một OnConfigUpdateListener để bắt đầu theo dõi các bản cập nhật và tự động tìm nạp mọi giá trị tham số mới hoặc đã cập nhật. Sau đó, hãy tạo một ConfigUpdateListenerEventHandler để xử lý các sự kiện cập nhật. Ví dụ sau đây theo dõi các bản cập nhật và sử dụng các giá trị mới tìm nạp được để hiển thị một thông báo chào mừng mới.

// 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;
}

Vào lần tiếp theo bạn xuất bản một phiên bản mới của Remote Config, những thiết bị đang chạy ứng dụng của bạn và chờ đợi các thay đổi sẽ gọi trình xử lý hoàn tất.

Các bước tiếp theo

Nếu chưa, hãy khám phá Remote Config các trường hợp sử dụng và xem một số tài liệu về các khái niệm chính và chiến lược nâng cao, bao gồm: