Catch up on everything we announced at this year's Firebase Summit. Learn more

Erstellen Sie dynamische Links mit Unity

Mit der Firebase Dynamic Links API können Sie kurze oder lange dynamische Links erstellen. Die API benötigt mehrere optionale Parameterstrukturen, um Links zu erstellen. Kurze Links können auch aus einem zuvor generierten langen Link erstellt werden. Die Dynamic Links API generiert eine URL wie die folgende:

https://example.page.link/aSDf

Bevor Sie beginnen

Bevor Sie können Firebase dynamische Links , 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 nicht über ein Unity - Projekt haben, können Sie eine Download - Beispielanwendung .

  • Fügen Sie die Firebase Unity SDK (genauer gesagt, FirebaseDynamicLinks.unitypackage ) , um Ihre Unity - Projekt.

Beachten Sie, dass das Hinzufügen Firebase zu Ihrer Unity Projektaufgabe beinhaltet sowohl in der Firebase - Konsole und in Ihrem geöffneten Projekt Unity (zum Beispiel downloaden Sie Config - Dateien Firebase aus der Konsole, dann in der Unity - Projekt bewegen).

Legen Sie ein Dynamic Links URI-Präfix fest

  1. In der Konsole Firebase öffnet Abschnitt des dynamischen Links.

  2. Wenn Sie die Nutzungsbedingungen noch nicht akzeptiert und ein URI-Präfix für Ihre Dynamic Links festgelegt haben, tun Sie dies, wenn Sie dazu aufgefordert werden.

    Wenn Sie bereits über ein Dynamic Links URI-Präfix verfügen, notieren Sie es. Sie müssen ein Dynamic Links URI-Präfix angeben, wenn Sie Dynamic Links programmgesteuert erstellen.

  3. Empfehlung: die URL - Muster in Ihren Deep - Links und Ausweich Links erlaubt angeben. Auf diese Weise verhindern Sie, dass Unbefugte dynamische Links erstellen, die von Ihrer Domain auf Websites umleiten, die Sie nicht kontrollieren. Siehe Weiße Liste URL - Muster .

Verwenden der Firebase-Konsole

Wenn Sie einen einzelnen Dynamic Link, entweder für Testzwecke erstellt werden sollen, oder für Ihr Marketing - Team einfach einen Link zu erstellen, in so etwas wie eine Social - Media - Post verwendet werden kann, wäre der einfachste Weg , um die besuchen Firebase Konsole und erstellen eine manuell das Schritt-für-Schritt-Formular befolgen.

Benutzerdefinierte Domains

Sie können eine größere Kontrolle über Ihre Dynamic Link Branding haben durch Ihre eigene Domain anstelle einer Verwendung von goo.gl oder page.link Subdomain. Befolgen Sie diese Anweisungen eine benutzerdefinierte Domain für Ihr Projekt einzurichten.

Verwenden der Firebase Dynamic Links API

Erstellen eines langen dynamischen Links aus Parametern

Um einen Dynamic Link zu erstellen, erstellen Sie eine DynamicLinkComponents Objekt, eine der optionalen Elemente für zusätzliche Konfigurationseinstellung und dann den Zugriff auf LongDynamicLink Eigenschaft die Link - URL zu erhalten.

Das folgende Minimalbeispiel erstellt einen langen dynamischen Link zu https://www.example.com/, der mit Ihrer Android-App com.example.android auf Android und der App com.example.ios auf iOS geöffnet wird:

var components = new Firebase.DynamicLinks.DynamicLinkComponents(
    // The base Link.
    new System.Uri("https://www.example.com/"),
    // The dynamic link URI prefix.
    "https://example.page.link") {
      IOSParameters = new Firebase.DynamicLinks.IOSParameters("com.example.ios"),
      AndroidParameters = new Firebase.DynamicLinks.AndroidParameters(
        "com.example.android.package_name"),
    };
// do something with: components.LongDynamicLink

Einen kurzen dynamischen Link erstellen

Um eine kurze Dynamic Link zu erstellen, übergeben eine zuvor erzeugte lange Verbindung zu Firebase.DynamicLinks.GetShortLinkAsync oder Build DynamicLinkComponents auf die gleiche Weise wie oben.

GetShortLinkAsync nimmt wahlweise eine zusätzliche DynamicLinkOptions Konfigurationsparameter mit dem PathLength Eigenschaft, so dass Sie steuern , wie der Link erzeugt werden soll. Kurzgliedrig Generation erfordert eine Netzwerkanforderung an den Back - End - Firebase, so dass das GetShortLinkAsync Verfahren asynchron ausgeführt wird. GetShortLinkAsync gibt eine Task<Firebase.DynamicLinks.ShortDynamicLink> .

Zum Beispiel:

var options = new Firebase.DynamicLinks.DynamicLinkOptions {
  PathLength = DynamicLinkPathLength.Unguessable
};

Firebase.DynamicLinks.DynamicLinks.GetShortLinkAsync(components, options).ContinueWith(task => {
  if (task.IsCanceled) {
    Debug.LogError("GetShortLinkAsync was canceled.");
    return;
  }
  if (task.IsFaulted) {
    Debug.LogError("GetShortLinkAsync encountered an error: " + task.Exception);
    return;
  }

  // Short Link has been created.
  Firebase.DynamicLinks.ShortDynamicLink link = task.Result;
  Debug.LogFormat("Generated short link {0}", link.Url);

  var warnings = new System.Collections.Generic.List<string>(link.Warnings);
  if (warnings.Count > 0) {
    // Debug logging for warnings generating the short link.
  }
});

Im obigen Beispiel wird ein Lambda-Ausdruck verwendet, der ausgelöst wird, wenn die Aufgabe abgeschlossen ist.