Расширенная интеграция (InStream API)

Реализуйте интерфейс InstreamAdPlayer.

В разделе справочника Package com.yandex.mobile.ads.instream.player.ad приведена подробная информация по работе методов и их реализации. Дополнительно рекомендуется ориентироваться на тестовый пример реализации.

Добавьте в layout приложения InstreamAdView. InstreamAdView должна содержать в себе PlayerView, в которой будут проигрываться рекламные ролики.

Пример кода:

Ограничение.

Размер контейнера должен быть не меньше 300dp x 160dp.

<com.yandex.mobile.ads.instream.player.ad.InstreamAdView
    android:id="@+id/instream_ad_view"
    android:layout_width="match_parent"
    android:layout_height="wrap_content">

        <PlayerView
            android:id="@+id/player_view"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"/>
        
</com.yandex.mobile.ads.instream.player.ad.InstreamAdView>

Загрузите через InstreamAdLoader объект InstreamAd с помощью идентификатора страницы (Page ID) из Партнерского интерфейса.

InstreamAd содержит в себе набор рекламных вставок разных типов. Чтобы получить рекламные вставки In-Roll, используйте InrollQueueProvider. Очередь InrollQueueProvider позволяет получать объекты In-Roll в необходимом для показа порядке.

public void onInstreamAdLoaded(@NonNull final InstreamAd instreamAd) {
    final InrollQueueProvider inrollQueueProvider = new InrollQueueProvider(context, instreamAd);
    mInstreamAdBreakQueue = inrollQueueProvider.getQueue();
}

Для запуска полученного In-Roll, необходимо его подготовить. Без подготовки In-Roll не запустится.

Чтобы подготовить In-Roll, вызовите Inroll.prepare(instreamAdPlayer) интерфейса и передайте в него инстанс созданной реализации InstreamAdPlayer. Для отслеживания состояния рекламной вставки установите слушатель InstreamAdBreakEventListener

public void prepare(instreamAdPlayer) {
   currentInroll = mInstreamAdBreakQueue.poll();
   currentInroll.setListener(new InrollListener());
   currentInroll.prepare(instreamAdPlayer);
}

По окончанию подготовки In-Roll будет вызван InstreamAdBreakEventListener.onInstreamAdBreakPrepared(). Подготовленный In-Roll готов к показу.

Чтобы показать подготовленный In-Roll, вызовите Inroll.play() и передайте в качестве параметра InstreamAdView.

public void onInstreamAdBreakPrepared() {
    if (currentInroll != null) {
        currentInroll.play(instreamAdView);
    }
}

После начала проигрывания рекламной вставки, будет вызван метод InstreamAdBreakEventListener.onInstreamAdBreakStarted(). По вызову этого метода необходимо поставить на паузу проигрывание основного видео и скрыть контролы управления основного видео.

public void onInstreamAdBreakPrepared() {
    if (contentVideoPlayer != null) {
        contentVideoPlayer.pauseVideo();
    }
}

После проигрывания рекламной вставки необходимо продолжить воспроизведение основного видео. Проигрывание рекламной вставки может завершиться успешно или с ошибкой, эти две ситуации необходимо обрабатывать.

@Override
public void onInstreamAdBreakCompleted() {
    handleAdBreakCompleted();
}

@Override
public void onInstreamAdBreakError(@NonNull final String reason) {
    handleAdBreakCompleted();
}

private void handleAdBreakCompleted() {
    currentInroll = null;
    if (contentVideoPlayer != null) {
        contentVideoPlayer.resumeVideo();
    }
}

После завершения проигрывания текущего InRoll проверьте очередь воспроизведения на наличие следующего In-Roll в InstreamAdBreakQueue.

public void prepareNextAd() {
   currentInroll = mInstreamAdBreakQueue.poll();
   if (currentInroll != null) {
       prepareInroll(currentInroll);
   }
}

При остановке использования In-Roll необходимо очищать его состояние.

public void onDestroy() {
    if (currentInroll != null) {
        currentInroll.invalidate();
        currentInroll.setListener(null);
    }
    super.onDestroy();
}