Google is committed to advancing racial equity for Black communities. See how.
Ta strona została przetłumaczona przez Cloud Translation API.
Switch to English

Zacznij korzystać z Firebase Remote Config for Unity

Możesz użyć Firebase Remote Config, aby zdefiniować parametry w swojej aplikacji i zaktualizować ich wartości w chmurze, umożliwiając modyfikowanie wyglądu i zachowania aplikacji bez dystrybuowania aktualizacji aplikacji.

Biblioteka Remote Config służy do przechowywania domyślnych wartości parametrów w aplikacji, pobierania zaktualizowanych wartości parametrów z zaplecza Remote Config i kontrolowania, kiedy pobrane wartości są udostępniane Twojej aplikacji. Aby dowiedzieć się więcej, zobacz Strategie ładowania Remote Config .

Ten przewodnik przeprowadzi Cię przez wszystkie kroki, aby rozpocząć, i zawiera przykładowy kod, który można sklonować lub pobrać z repozytorium GitHub Firebase / quickstart-unity .

Dodaj zdalną konfigurację do swojej aplikacji

Aby móc korzystać ze Zdalnej konfiguracji , musisz:

  • Zarejestruj swój projekt Unity i skonfiguruj go do korzystania z Firebase.

    • Jeśli Twój projekt Unity korzysta już z Firebase, oznacza to, że jest już zarejestrowany i skonfigurowany dla Firebase.

    • Jeśli nie masz projektu Unity, możesz pobrać przykładową aplikację .

  • Dodaj pakiet Firebase Unity SDK (w szczególności FirebaseRemoteConfig.unitypackage ) do projektu Unity.

Pamiętaj, że dodanie Firebase do projektu Unity obejmuje zadania zarówno w konsoli Firebase, jak i w otwartym projekcie Unity (na przykład pobierasz pliki konfiguracyjne Firebase z konsoli, a następnie przenosisz je do projektu Unity).

Ustaw domyślne wartości parametrów w aplikacji

W obiekcie Remote Config można ustawić domyślne wartości parametrów, które będą używane, jeśli żadne inne wartości nie zostały pobrane z zaplecza. Dzięki temu Twoja aplikacja będzie działać zgodnie z zamierzeniami, zanim połączy się z zapleczem Zdalnej konfiguracji.

Aby to zrobić, utwórz słownik ciągów i zapełnij go parami klucz / wartość reprezentującymi wartości domyślne, które chcesz dodać. (Właściwości niebędące ciągami zostaną przekonwertowane na typ właściwości po SetDefaults ).

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.SetDefaults(defaults);

Uzyskaj wartości parametrów do użycia w swojej aplikacji

Teraz możesz pobrać wartości parametrów z obiektu Remote Config. Jeśli ustawisz wartości w zapleczu Zdalnej konfiguracji, pobierzesz je, a następnie aktywujesz, te wartości będą dostępne dla Twojej aplikacji. W przeciwnym razie uzyskasz wartości parametrów w aplikacji skonfigurowane za pomocą SetDefaults () .

Aby uzyskać te wartości, użyj funkcji GetValue () , podając klucz parametru jako argument. Zwraca wartość ConfigValue , która ma właściwości umożliwiające konwersję wartości na różne typy podstawowe.

Połącz swoją aplikację z konsolą Firebase

W konsoli Firebase dodaj aplikację do projektu Firebase.

Ustaw wartości parametrów

  1. Otwórz projekt w konsoli Firebase .
  2. Wybierz Remote Config z menu, aby wyświetlić panel kontrolny Remote Config.
  3. Zdefiniuj parametry o takich samych nazwach, jak parametry zdefiniowane w aplikacji. Dla każdego parametru można ustawić wartość domyślną (która ostatecznie zastąpi wartość domyślną w aplikacji) i wartości warunkowe. Aby dowiedzieć się więcej, zobacz Parametry i warunki zdalnej konfiguracji .

Pobierz i aktywuj wartości (w razie potrzeby)

Aby pobrać wartości parametrów z zaplecza FetchAsync() metodę FetchAsync() . Wszelkie wartości ustawione w zapleczu są pobierane i zapisywane w pamięci podręcznej w obiekcie 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.FetchAsync(
      TimeSpan.Zero);
  return fetchTask.ContinueWithOnMainThread(FetchComplete);
}

Wartości pobierane przez FetchAsync() są buforowane lokalnie po zakończeniu pobierania, ale nie są udostępniane do momentu wywołania ActivateFetched() . Ponieważ FetchAsync() wykonywana asynchronicznie, umożliwia to upewnienie się, że nowe wartości nie są stosowane w trakcie obliczania lub w innych sytuacjach, które mogą powodować problemy lub dziwne zachowanie.

(Opcjonalnie) Włącz tryb programisty

Aby włączyć tryb programisty, który może być używany do wyłączania dławienie podczas rozwoju, można użyć FirebaseRemoteConfig.Setting własności, ustanawiając nowy ConfigSettings z IsDeveloperMode wartość true.

Następne kroki

Jeśli jeszcze tego nie zrobiłeś, zapoznaj się z przypadkami użycia Remote Config i zapoznaj się z niektórymi kluczowymi pojęciami i dokumentacją zaawansowanych strategii, w tym: