Google is committed to advancing racial equity for Black communities. See how.
Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

Erste Schritte mit Firebase Remote Config for Unity

Mit Firebase Remote Config können Sie Parameter in Ihrer App definieren und deren Werte in der Cloud aktualisieren. So können Sie das Erscheinungsbild und Verhalten Ihrer App ändern, ohne ein App-Update zu verteilen.

In der Remote Config-Bibliothek werden Standardparameterwerte in der App gespeichert, aktualisierte Parameterwerte aus dem Remote Config-Backend abgerufen und gesteuert, wann abgerufene Werte Ihrer App zur Verfügung gestellt werden. Weitere Informationen finden Sie unter Ladestrategien für Remote-Konfiguration .

Diese Anleitung führt Sie durch die ersten Schritte und enthält Beispielcode, der zum Klonen oder Herunterladen aus dem GitHub-Repository von firebase / quickstart-entity verfügbar ist.

Fügen Sie Ihrer App Remote Config hinzu

Bevor Sie Remote Config verwenden können , müssen Sie:

  • Registrieren Sie Ihr Unity-Projekt und konfigurieren Sie es für die Verwendung von Firebase.

    • Wenn Ihr Unity-Projekt bereits Firebase verwendet, ist es bereits für Firebase registriert und konfiguriert.

    • Wenn Sie kein Unity-Projekt haben, können Sie eine Beispiel-App herunterladen.

  • Fügen Sie das Firebase Unity SDK (insbesondere FirebaseRemoteConfig.unitypackage ) zu Ihrem Unity-Projekt hinzu.

Beachten Sie, dass das Hinzufügen von Firebase zu Ihrem Unity-Projekt Aufgaben sowohl in der Firebase-Konsole als auch in Ihrem geöffneten Unity-Projekt umfasst (Sie laden beispielsweise Firebase-Konfigurationsdateien von der Konsole herunter und verschieben sie dann in Ihr Unity-Projekt).

Festlegen von In-App-Standardparameterwerten

Sie können Standardparameterwerte im Remote Config-Objekt festlegen, die verwendet werden sollen, wenn keine anderen Werte aus dem Backend abgerufen wurden. Dadurch kann sich Ihre App wie beabsichtigt verhalten, bevor sie eine Verbindung zum Remote Config-Backend herstellt.

Erstellen Sie dazu ein Zeichenfolgenwörterbuch und füllen Sie es mit Schlüssel / Wert-Paaren, die die Standardeinstellungen darstellen, die Sie hinzufügen möchten. (Nicht-String-Eigenschaften werden beim SetDefaults den Typ der Eigenschaft konvertiert.)

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);

Holen Sie sich Parameterwerte zur Verwendung in Ihrer App

Jetzt können Sie Parameterwerte vom Remote Config-Objekt abrufen. Wenn Sie im Remote Config-Backend Werte festlegen, diese abrufen und dann aktivieren, stehen diese Werte Ihrer App zur Verfügung. Andernfalls erhalten Sie die In-App-Parameterwerte, die mit SetDefaults () konfiguriert wurden.

Verwenden Sie GetValue () , um diese Werte abzurufen , und geben Sie den Parameterschlüssel als Argument an. Dies gibt einen ConfigValue zurück , der Eigenschaften zum Konvertieren des Werts in verschiedene Basistypen aufweist.

Verbinden Sie Ihre App in der Firebase-Konsole

Fügen Sie in der Firebase-Konsole Ihre App zu Ihrem Firebase-Projekt hinzu.

Parameterwerte einstellen

  1. Öffnen Sie in der Firebase-Konsole Ihr Projekt.
  2. Wählen Sie Remote Config aus dem Menü, um das Remote Config-Dashboard anzuzeigen.
  3. Definieren Sie Parameter mit denselben Namen wie die Parameter, die Sie in Ihrer App definiert haben. Für jeden Parameter können Sie einen Standardwert (der eventuell den Standardwert in der App überschreibt) und bedingte Werte festlegen. Weitere Informationen finden Sie unter Parameter und Bedingungen für die Remote-Konfiguration .

Werte abrufen und aktivieren (nach Bedarf)

Rufen Sie die FetchAsync() -Methode auf, um Parameterwerte aus dem Remote Config-Backend FetchAsync() . Alle im Backend festgelegten Werte werden im Remote Config-Objekt abgerufen und zwischengespeichert.

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

Über FetchAsync() abgerufene Werte werden nach Abschluss des FetchAsync() lokal zwischengespeichert, jedoch erst verfügbar, wenn ActivateFetched() aufgerufen wird. Da FetchAsync() asynchron ausgeführt wird, können Sie sicherstellen, dass die neuen Werte nicht FetchAsync() Berechnung oder zu anderen Zeiten angewendet werden, die Probleme oder seltsames Verhalten verursachen können.

(Optional) Aktivieren Sie den Entwicklermodus

Um den Entwicklermodus zu aktivieren, mit dem die Drosselung während der Entwicklung deaktiviert werden kann, können Sie die Eigenschaft FirebaseRemoteConfig.Setting und ein neues ConfigSettings mit IsDeveloperMode auf true setzen.

Nächste Schritte

Wenn Sie dies noch nicht getan haben , lesen Sie die Anwendungsfälle für die Remote-Konfiguration und sehen Sie sich einige der wichtigsten Konzepte und Dokumentationen zu erweiterten Strategien an, darunter: