Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

Twórz dynamiczne linki z Unity

Za pomocą interfejsu Firebase Dynamic Links API możesz tworzyć krótkie lub długie linki dynamiczne. Interfejs API wykorzystuje kilka opcjonalnych struktur parametrów do tworzenia łączy. Krótkie linki można również tworzyć z wcześniej wygenerowanego długiego linku. Dynamic Links API wygeneruje adres URL podobny do następującego:

https://example.page.link/aSDf

Zanim zaczniesz

Aby móc korzystać z Linków dynamicznych Firebase , 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 SDK Firebase Unity (w szczególności FirebaseDynamicLinks.unitypackage ) do swojego 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 swojego projektu Unity).

Ustaw prefiks identyfikatora URI linków dynamicznych

  1. W konsoli Firebase otwórz sekcję Linki dynamiczne .

  2. Jeśli nie zaakceptowałeś jeszcze warunków korzystania z usługi i ustawiłeś prefiks URI dla linków dynamicznych, zrób to po wyświetleniu monitu.

    Jeśli masz już prefiks identyfikatora URI Dynamic Links, zanotuj go. Musisz podać prefiks identyfikatora URI linków dynamicznych podczas programowego tworzenia linków dynamicznych.

  3. Zalecane : określ wzorce adresów URL dozwolone w precyzyjnych linkach i linkach zastępczych. W ten sposób uniemożliwiasz nieautoryzowanym stronom tworzenie linków dynamicznych, które przekierowują z Twojej domeny do witryn, których nie kontrolujesz. Zobacz Biała lista wzorców adresów URL .

Użyj konsoli Firebase

Jeśli chcesz wygenerować pojedynczy link dynamiczny, albo do celów testowych, albo dla swojego zespołu marketingowego, aby łatwo utworzyć link, który można wykorzystać w czymś takim jak post w mediach społecznościowych, najprostszym sposobem jest odwiedzenie konsoli Firebase i utworzenie takiego linku ręcznie postępując zgodnie z formularzem krok po kroku.

Domeny niestandardowe

Możesz mieć większą kontrolę nad marką Dynamic Link, używając własnej domeny zamiast subdomeny goo.gl lub page.link . Postępuj zgodnie z tymi instrukcjami, aby skonfigurować niestandardową domenę dla swojego projektu.

Korzystanie z interfejsu Firebase Dynamic Links API

Tworzenie długiego łącza dynamicznego z parametrów

Aby utworzyć łącze dynamiczne, utwórz obiekt DynamicLinkComponents , ustawiając dowolny z opcjonalnych elementów członkowskich dla dodatkowej konfiguracji, a następnie LongDynamicLink dostęp do właściwości LongDynamicLink aby uzyskać adres URL łącza.

Poniższy minimalny przykład tworzy długi link dynamiczny do https://www.example.com/, który otwiera się w Twojej aplikacji na Androida com.example.android na Androida i aplikacji 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

Tworzenie krótkiego łącza dynamicznego

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

GetShortLinkAsync opcjonalnie pobiera dodatkowy parametr konfiguracji DynamicLinkOptions z właściwością PathLength , co pozwala kontrolować sposób generowania linku. Generowanie krótkich linków wymaga żądania sieciowego do zaplecza GetShortLinkAsync , więc metoda GetShortLinkAsync jest wykonywana asynchronicznie. GetShortLinkAsync zwraca Task<Firebase.DynamicLinks.ShortDynamicLink> .

Na 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 powyższym przykładzie zastosowano wyrażenie lambda, które jest wyzwalane po zakończeniu zadania.