Tworzenie linków dynamicznych w Unity

Krótkie i długie Dynamic Links możesz tworzyć za pomocą interfejsu API Firebase Dynamic Links. Interfejs API wymaga kilku opcjonalnych struktur parametrów do utworzenia linków. Krótkie linki mogą utworzony na podstawie wcześniej wygenerowanego długiego linku. Interfejs Dynamic Links API wygeneruje URL podobny do tego:

https://example.page.link/aSDf

Zanim zaczniesz

Zanim będzie można użyć Firebase Dynamic Links musisz:

  • Zarejestruj projekt Unity i skonfiguruj go pod kątem korzystania z Firebase.

    • Jeśli Twój projekt w Unity korzysta już z Firebase, zarejestrowane i skonfigurowane w Firebase.

    • Jeśli nie masz projektu Unity, możesz pobrać przykładowej aplikacji.

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

.

Pamiętaj, że dodanie Firebase do projektu Unity wymaga wykonania zadań zarówno w Firebase i w otwartym projekcie Unity (np. pobierasz z konsoli pliki konfiguracyjne Firebase, do swojego projektu Unity).

Ustaw prefiks identyfikatora URI Dynamic Links

  1. W konsoli Firebase otwórz sekcję Dynamic Links.

  2. Jeśli Warunki korzystania z usługi nie zostały jeszcze zaakceptowane i ustawiono prefiks identyfikatora URI dla Dynamic Links, zrób to, gdy pojawi się odpowiedni komunikat.

    Jeśli masz już prefiks identyfikatora URI Dynamic Links, zanotuj go. Czynności, które musisz wykonać podaj prefiks identyfikatora URI Dynamic Links podczas automatycznego tworzenia obiektu Dynamic Links.

  3. Zalecane: określ wzorce adresów URL dozwolone w Twoich precyzyjnych linkach i . Pozwoli to uniemożliwić nieupoważnionym osobom Tworząc adresy URL Dynamic Links, które przekierowują z Twojej domeny na strony internetowe, których nie używasz . Zobacz Umieszczanie wzorców adresów URL na białej liście.

Korzystanie z konsoli Firebase

Jeśli chcesz wygenerować pojedynczy element Dynamic Link do celów testowych lub na potrzeby zespołu marketingowego aby utworzyć link, którego można użyć np. w poście w mediach społecznościowych, odwiedź konsolę Firebase i utworzyć ją ręcznie, postępując zgodnie z instrukcjami.

Domeny niestandardowe

Możesz mieć większą kontrolę nad promowaniem marki Dynamic Link, używając własnych zamiast subdomeny goo.gl lub page.link. Obserwuj te instrukcje konfigurowania domeny niestandardowej do swojego projektu.

Za pomocą interfejsu API Firebase Dynamic Links

Tworzę długi Dynamic Link na podstawie parametrów

Aby utworzyć link dynamiczny, utwórz obiekt DynamicLinkComponents, ustawiając dowolną wartość opcjonalnych użytkowników, aby przeprowadzić dodatkową konfigurację, a następnie uzyskać dostęp do LongDynamicLink, aby uzyskać adres URL linku.

Poniższy minimalny przykład pozwala utworzyć długi link dynamiczny do https://www.example.com/ otwiera się w aplikacji na Androida. com.example.android w przypadku Androida, a aplikacja com.example.ios na iOS:

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

Tworzę krótki format Dynamic Link

Aby utworzyć krótki link dynamiczny, przekaż wcześniej wygenerowany długi link do Firebase.DynamicLinks.GetShortLinkAsync lub wbudowany DynamicLinkComponents w taki sam sposób jak powyżej.

GetShortLinkAsync opcjonalnie pobiera dodatkową konfigurację DynamicLinkOptions za pomocą właściwości PathLength, co pozwala kontrolować, . Wygenerowanie krótkiego linku wymaga wysłania żądania sieciowego do backend Firebase, więc metoda GetShortLinkAsync jest wykonywana asynchronicznie. GetShortLinkAsync zwraca wartość Task<Firebase.DynamicLinks.ShortDynamicLink>.

Przykład:

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

W przykładzie powyżej użyto wyrażenia lambda, które jest wywoływane, gdy zadanie jest: .