В этом руководстве показано, как реализовать закладки с помощью IMA DAI SDK при использовании динамической вставки рекламы (DAI) для потоков видео по запросу (VOD). Предполагается наличие работающей реализации IMA DAI, например, представленной в разделе «Начало работы» .
Что такое закладки?
Закладки — это возможность сохранять и возвращаться к определённому моменту в потоке контента. Предположим, пользователь смотрит пять минут контента, выходит из потока и затем возвращается к нему. Закладки сохраняют текущее положение пользователя в потоке, чтобы можно было продолжить просмотр с того места, где он остановился, обеспечивая зрителям бесперебойный просмотр.
Закладки DAI изнутри
При добавлении трансляции DAI в закладки необходимо записать идентификатор трансляции и время, когда пользователь покидает видео. Когда пользователь возвращается, повторно запросите трансляцию и найдите сохранённое время. Поскольку каждый экземпляр запрошенной трансляции может содержать рекламные паузы разной длительности, простое сохранение времени трансляции не сработает. На самом деле, вам нужно продолжить просмотр с того же времени .
Методы преобразования спешат на помощь
SDK IMA DAI предоставляет два метода для запроса времени контента для заданного времени потока и времени потока для заданного времени контента . Используя эти методы преобразования, можно сохранить время контента, добавленного в закладки, а затем искать соответствующее время потока в новом экземпляре потока. Ниже представлен подход, включая ссылку на пример приложения, демонстрирующего работающую реализацию закладок.
Сохранение закладок
Сохраните закладку, когда Activity приостановлено.
private double bookmarkTime;
@Override
public void onPause() {
super.onPause();
double streamTime = videoPlayer.getCurrentPosition() / 1000.0; // ms to s.
bookmarkTime = streamManager.getContentTimeForStreamTime(streamTime);
}
Загрузка закладок
Загружайте закладку при повторном запросе потока. Это часть реализации интерфейса VideoStreamPlayer .
public void loadUrl(String url, List<HashMap<String, String>> subtitles) {
// Set video player's stream URL and subtitles, and play the stream.
...
// Bookmarking.
if (bookmarkTime > 0) {
double streamTime =
streamManager.getStreamTimeForContentTime(bookmarkTime);
videoPlayer.seek((long) (streamTime * 1000.0)); // s to ms.
}
}
Пример приложения
Загрузите пример приложения , чтобы увидеть реализацию закладок.