Создавайте динамические ссылки с помощью Unity

Вы можете создавать короткие или длинные Dynamic Links с помощью Firebase Dynamic Links API. API принимает несколько необязательных структур параметров для создания ссылок. Короткие ссылки также могут быть созданы из ранее созданной длинной ссылки. Dynamic Links API сгенерирует URL-адрес следующего вида:

https://example.page.link/aSDf

Прежде чем начать

Прежде чем использовать Firebase Dynamic Links , вам необходимо:

  • Зарегистрируйте свой проект Unity и настройте его для использования Firebase.

    • Если ваш проект Unity уже использует Firebase, значит, он уже зарегистрирован и настроен для Firebase.

    • Если у вас нет проекта Unity, вы можете загрузить пример приложения .

  • Добавьте Firebase Unity SDK (в частности, FirebaseDynamicLinks.unitypackage ) в свой проект Unity.

Обратите внимание, что добавление Firebase в проект Unity включает в себя выполнение задач как в консоли Firebase , так и в открытом проекте Unity (например, вы загружаете файлы конфигурации Firebase из консоли, а затем перемещаете их в проект Unity).

Установите префикс URI Dynamic Links

  1. В консоли Firebase откройте раздел Dynamic Links .

  2. Если вы еще не приняли условия обслуживания и не установили префикс URI для своих Dynamic Links , сделайте это при появлении соответствующего запроса.

    Если у вас уже есть префикс URI Dynamic Links , запишите его. Вам необходимо указать префикс URI Dynamic Links при программном создании Dynamic Links .

  3. Рекомендуется : Укажите шаблоны URL, разрешенные в ваших глубоких ссылках и резервных ссылках. Таким образом, вы предотвращаете создание неавторизованными сторонами Dynamic Links , которые перенаправляют с вашего домена на сайты, которые вы не контролируете. См. Разрешить определенные шаблоны URL .

Используйте консоль Firebase

Если вы хотите создать одну Dynamic Link , либо для целей тестирования, либо для того, чтобы ваша маркетинговая команда могла легко создать ссылку, которую можно использовать, например, в публикации в социальных сетях, самый простой способ — зайти в консоль Firebase и создать ссылку вручную, следуя пошаговой форме.

Пользовательские домены

Вы можете иметь больший контроль над брендингом Dynamic Link , используя собственный домен вместо поддомена goo.gl или page.link . Следуйте этим инструкциям , чтобы настроить пользовательский домен для вашего проекта.

Использование API Firebase Dynamic Links

Создание длинной Dynamic Link из параметров

Чтобы создать динамическую ссылку, создайте объект DynamicLinkComponents , задав любые необязательные элементы для дополнительной конфигурации, а затем получите доступ к свойству LongDynamicLink , чтобы получить URL-адрес ссылки.

Следующий минимальный пример создает длинную динамическую ссылку на https://www.example.com/, которая открывается с помощью вашего приложения Android com.example.android на Android и приложения com.example.ios на 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

Создание короткой Dynamic Link

Чтобы создать короткую динамическую ссылку, передайте ранее сгенерированную длинную ссылку в Firebase.DynamicLinks.GetShortLinkAsync или создайте DynamicLinkComponents таким же образом, как описано выше.

GetShortLinkAsync опционально принимает дополнительный параметр конфигурации DynamicLinkOptions со свойством PathLength , что позволяет вам контролировать, как должна быть сгенерирована ссылка. Генерация короткой ссылки требует сетевого запроса к бэкэнду Firebase, поэтому метод GetShortLinkAsync выполняется асинхронно. GetShortLinkAsync возвращает Task<Firebase.DynamicLinks.ShortDynamicLink> .

Например:

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

В приведенном выше примере используется лямбда-выражение, которое срабатывает после завершения задачи.