Skip to content

Параметр setUrlCleaner

Описание

Метод setUrlCleaner в TeleportConfiguration.Builder позволяет определить функцию для унификации URL-адресов манифестов и видео-сегментов. Его основная задача — удаление из URL любой уникальной информации (например, токены авторизации, идентификаторы сессий, временные метки), которая не влияет на уникальность самого контента, но может меняться для разных пользователей или сессий.

Зачем это нужно?

Для корректной работы Teleport PDN (Peer-to-Peer Delivery Network) крайне важно, чтобы URL одного и того же видео-сегмента или манифеста был идентичен для всех пиров в сети. Это позволяет SDK правильно сопоставлять контент и эффективно обмениваться им.

Требования к функции

  • Функция должна принимать Uri и возвращать String (унифицированный URL).
  • Вызывается на бэкграунд потоке.

Последствия без setUrlCleaner

Без правильной унификации URL, Teleport SDK может ошибочно считать один и тот же сегмент разным контентом для разных пользователей. Это препятствует формированию пиринговой сети и значительно снижает эффективность P2P-доставки.

Пример использования

kotlin
TeleportConfiguration.Builder("YOUR_API_KEY")
        .setUrlCleaner { uri: Uri ->
            // Пример: оставляет только путь URL, отбрасывая query-параметры
            uri.path.orEmpty()
        }
        .build()

В этом примере setUrlCleaner использует Uri.path для получения только пути URL, игнорируя все query-параметры. Вы можете адаптировать эту функцию под специфику ваших URL.