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

Erstellen Sie dynamische Links mit Unity

Mit der Firebase Dynamic Links API können Sie kurze oder lange dynamische Links erstellen. Die API verwendet 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 Firebase Dynamic Links 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 FirebaseDynamicLinks.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).

Legen Sie ein URI-Präfix für dynamische Links fest

  1. Öffnen Sie in der Firebase-Konsole den Abschnitt Dynamische Links .

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

    Wenn Sie bereits ein URI-Präfix für dynamische Links haben, notieren Sie es. Sie müssen ein URI-Präfix für dynamische Links angeben, wenn Sie programmgesteuert dynamische Links erstellen.

  3. Empfohlen : Geben Sie die URL-Muster an, die in Ihren Deep Links und Fallback-Links zulässig sind. Auf diese Weise verhindern Sie, dass Unbefugte dynamische Links erstellen, die von Ihrer Domain zu Websites umleiten, die Sie nicht kontrollieren. Siehe Whitelist-URL-Muster .

Verwenden Sie die Firebase-Konsole

Wenn Sie einen einzelnen dynamischen Link generieren möchten, entweder zu Testzwecken oder damit Ihr Marketingteam auf einfache Weise einen Link erstellen kann, der in einem Social-Media-Beitrag verwendet werden kann, ist es am einfachsten, die Firebase-Konsole zu besuchen und einen zu erstellen manuell dem Schritt-für-Schritt-Formular folgen.

Benutzerdefinierte Domains

Sie können das Branding Ihres Dynamic Links goo.gl page.link indem Sie Ihre eigene Domain anstelle einer goo.gl oder page.link Subdomain verwenden. Befolgen Sie diese Anweisungen , um eine benutzerdefinierte Domäne für Ihr Projekt einzurichten.

Verwenden der Firebase Dynamic Links API

Erstellen einer langen dynamischen Verbindung aus Parametern

Um einen dynamischen Link zu erstellen, erstellen Sie ein DynamicLinkComponents Objekt, DynamicLinkComponents eines der optionalen DynamicLinkComponents für die zusätzliche Konfiguration fest und greifen LongDynamicLink dann auf die LongDynamicLink Eigenschaft zu, um die Link-URL LongDynamicLink .

Das folgende minimale Beispiel erstellt einen langen dynamischen Link zu https://www.example.com/, der mit Ihrer Android-App com.example.android unter Android und der App com.example.ios unter 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

Erstellen einer kurzen dynamischen Verbindung

Um einen kurzen dynamischen Link zu erstellen, übergeben Sie einen zuvor generierten langen Link an Firebase.DynamicLinks.GetShortLinkAsync oder erstellen Sie DynamicLinkComponents auf die gleiche Weise wie oben.

GetShortLinkAsync optional einen zusätzlichen DynamicLinkOptions Konfigurationsparameter mit der PathLength Eigenschaft, mit dem Sie steuern können, wie der Link generiert werden soll. Die Generierung kurzer Verbindungen erfordert eine Netzwerkanforderung an das Firebase-Backend, sodass die GetShortLinkAsync Methode asynchron ausgeführt wird. GetShortLinkAsync gibt eine Task<Firebase.DynamicLinks.ShortDynamicLink> .

Beispielsweise:

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.