Сохранение и загрузка закладок рекламного потока

Выберите платформу: HTML5 Android iOS tvOS Roku

В этом руководстве показано, как реализовать закладки с помощью IMA DAI SDK при использовании динамической вставки рекламы (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);
}

Пример приложения

Загрузите пример приложения , чтобы увидеть реализацию закладок.