Интеграция Teleport SDK с Shaka Player
Этот раздел содержит инструкции по интеграции Teleport SDK с медиаплеером Shaka Player для воспроизведения DASH- и HLS-контента.
1. Подключение скриптов
Убедитесь, что вы подключили основной скрипт Teleport SDK и лоадер для Shaka Player. Вы можете использовать отдельные скрипты или готовый бандл.
Отдельные скрипты:
<!-- Основной скрипт Teleport SDK -->
<script src="https://cdn.teleport.media/stable/teleport.js"></script>
<!-- Лоадер для Shaka Player -->
<script src="https://cdn.teleport.media/stable/teleport.shaka.js"></script>Бандл (включает SDK, лоадер и полифилы):
<script src="https://cdn.teleport.media/stable/teleport.shaka.bundle.js"></script>2. Инициализация Teleport SDK
После подключения скриптов необходимо инициализировать Teleport SDK, передав ваш API-ключ и экземпляр плеера.
// 1. Инициализируйте Shaka Player
shaka.polyfill.installAll();
const videoElement = document.getElementById('video'); // Замените 'video' на ID вашего <video> элемента
const player = new shaka.Player(videoElement);
// 2. Инициализируйте Teleport SDK
teleport.initialize({
apiKey: "YOUR_API_KEY", // Ваш API-ключ из кабинета Teleport
loader: {
type: "shaka", // Идентификатор плагина для Shaka Player
params: {
player: player, // Передайте экземпляр Shaka Player
shakaModule: shaka // (Начиная с версии 1.95.72) Опционально: модуль Shaka Player
}
}
})
.then(function (instance) {
console.log('Teleport SDK успешно инициализирован для Shaka Player!', instance);
// Здесь можно загрузить ваш манифест
player.load('YOUR_MANIFEST_URL'); // URL вашего DASH/HLS манифеста
})
.catch(function (error) {
console.error('Ошибка инициализации Teleport SDK:', error);
});
// Опционально: освобождение ресурсов Teleport при закрытии страницы
window.addEventListener("unload", function () {
if (tlprt) {
tlprt.dispose();
tlprt = null;
}
});Использование с ES-модулями / бандлерами (начиная с v1.95.72)
Начиная с версии 1.95.72, Teleport SDK поддерживает работу без обязательного присутствия shaka в глобальной области видимости (window.shaka).
Если в вашем проекте Shaka Player импортируется локально (например, import shaka from 'shaka-player'), передайте объект библиотеки через параметр shakaModule:
import shaka from 'shaka-player';
// Инициализация плеера
shaka.polyfill.installAll();
const player = new shaka.Player(videoElement);
teleport.initialize({
apiKey: "YOUR_API_KEY",
loader: {
type: "shaka",
params: {
player: player,
shakaModule: shaka // Прямая передача модуля Shaka Player (доступно с v1.95.72)
}
}
});Изоляция экземпляров (с версии 1.95.72)
Начиная с версии 1.95.72, плагин изолирует перехват сетевых запросов на уровне конкретного экземпляра: Teleport обрабатывает только трафик того плеера, который был передан в params.player. Другие инстансы Shaka Player на странице, не подключенные к Teleport, работают в штатном режиме без перехвата запросов.
Дополнительная настройка
Для более тонкой настройки поведения Teleport SDK (например, очистка URL, определение качества сегментов), ознакомьтесь с разделом Конфигурация.