В этом руководстве показано, как реализовать функцию добавления закладок с помощью SDK IMA DAI при использовании динамической вставки рекламы (DAI) для видеопотоков по запросу (VOD). Предполагается наличие работающей реализации IMA DAI, например, той, что представлена в разделе «Начало работы» .
Что такое закладки?
Закладки — это возможность сохранить и затем вернуться к определенному моменту в потоке контента. Допустим, пользователь смотрит пять минут контента, выходит из видеопотока, а затем возвращается к нему. Закладки сохраняют позицию пользователя в потоке, чтобы поток мог продолжить просмотр с того места, где он остановился, обеспечивая зрителю бесперебойное взаимодействие.
Функция закладок DAI работает «под капотом».
При добавлении потока DAI в закладки необходимо записать идентификатор потока и время, когда пользователь покидает видео. Когда пользователь возвращается, повторно запросите поток и перейдите к сохраненному времени. Поскольку каждый экземпляр запрошенного потока может содержать рекламные паузы разной продолжительности, простое сохранение времени потока не сработает. Вам нужно продолжить просмотр с того же временного интервала .
На помощь приходят методы переоборудования.
SDK IMA DAI предоставляет пару методов для запроса времени содержимого для заданного времени потока и времени потока для заданного времени содержимого . Используя эти методы преобразования, вы можете сохранить закладку времени содержимого , а затем перейти к соответствующему времени потока в новом экземпляре потока. Вот подход, включая ссылку на пример приложения, демонстрирующий работающую реализацию закладок.
Сохранение и загрузка закладок рекламного потока.
Сохранять закладку, когда воспроизведение контента приостановлено.
onPause() {
var bookmarkTime = Math.floor(
streamManager.contentTimeForStreamTime(videoElement.currentTime));
}
Загрузка закладок
Закладка будет загружаться при повторном запросе потока.
function loadUrl(url) {
hls.on(Hls.Events.MANIFEST_PARSED, () => {
var startTime = 0;
if (bookmarkTime) {
var startTime = streamManager.streamTimeForContentTime(bookmarkTime);
// Seeking on load triggers the onSeekEnd event, so treat this seek as
// if it's snapback. Without this, resuming at a bookmark kicks you
// back to the ad before the bookmark.
isSnapback = true;
}
hls.startLoad(startTime);
videoElement.addEventListener('loadedmetadata', () => { videoElement.play(); });
});
hls.loadSource(url);
hls.attachMedia(videoElement);
}
Пример приложения
Загрузите демонстрационное приложение , чтобы увидеть пример реализации функции добавления закладок.