Параметр urlCleaner

Описание

Параметр urlCleaner предоставляет функцию для унификации URL-адресов видео-сегментов и манифестов. Его основная задача — удаление из URL любой уникальной информации, которая может меняться от пользователя к пользователю или от сессии к сессии, но не влияет на идентификацию самого контента.

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

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

Когда это необходимо?

Если ваш медиасервер добавляет в URL динамические параметры (например, токены авторизации, идентификаторы сессий, временные метки), которые не являются частью уникального идентификатора контента, вам необходимо использовать urlCleaner.

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

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

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

let tlprt = await teleport.initialize({
    apiKey: "YOUR_API_KEY", // Ваш API-ключ
    loader: {
        type: "PLUGIN_ID", // Идентификатор используемого плагина плеера
        params: {
            // Функция для очистки URL: оставляет только путь, отбрасывая query-параметры
            urlCleaner: url => (new URL(url)).pathname
        }
    }
});

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