Интеграция в SmartTV

Использовать Video Ads SDK в SmartTV приложениях возможно при стандартной интеграции с использованием модуля AdLoader. Инструкцию по подключению можно найти тут.

Поддерживаемые платформы:

• Webos

• Tizen

• VIDAA

• WebView внутри AndroidTV

Дополнительные требования для подключения Video Ads SDK в SmartTV

1. При вызове метода AdLoader.create в параметрах конфигурации необходимо передавать targetRef со строковым значением адреса веб-версии вашего сервиса (например, targetRef: "https://hd.kinopoisk.ru").

2. Чтобы скрыть все элементы интерфейса Video Ads SDK и оставить только видео, при вызове метода AdStore.createAdPlaybackController в параметрах воспроизведения необходимо передать в настройках controlsSettings объект {visibility: false}.

3. В настройках controlsSettings в поле controlsVisibility добавьте одно из следующих значений, чтобы включить адаптированные для SmartTV контролы:

   • abuse: true – «кебаб» с информацией о рекламодателе (юридические данные, erid и прочее);

   • skip: true – кнопка пропуска рекламного ролика;

   • adLabel: true – плашка «Реклама» внизу рекламного ролика (включает отображение erid);

   • ageLabel: true – плашка с ограничением по возрасту.

Фокусная система

При использовании контрола «кебаб» с информацией о рекламодателе и контрола с кнопкой «Пропустить» необходимо передать управление фокусной системой в интерфейс Video Ads SDK. Это можно сделать двумя способами:

1. Перед вызовом метода AdStore.createAdPlaybackController выставить data-атрибут data-focused="true" на элементе slot.

   slot.setAttribute("data-focused", "true");
   adStore.createAdPlaybackController(video, slot, playbackParameters);
   

2. В любой момент воспроизведения через вызов событий focus/blur на элементе slot (рекомендуемый вариант).

   adStore.createAdPlaybackController(video, slot, playbackParameters);
   
   adPlaybackController.subscribe("AdStarted", () =>
     slot.dispatchEvent(new Event("focus")),
   );
   
   adPlaybackController.subscribe("AdStopped", () =>
     slot.dispatchEvent(new Event("blur")),
   );
   

При передаче управления фокусами на сторону Video Ads SDK интерфейс будет сам перехватывать нажатия на кнопки пульта ДУ устройства и перестанет это делать после завершения рекламы.