In-stream видео Android

private InstreamAd ad;

private void initAd()
{
   // Включение режима отладки
   // MyTargetManager.setDebugMode(true);

   // Создаем экземпляр InstreamAd
   ad = new InstreamAd(YOUR_SLOT_ID, this);
}

private InstreamAd ad;

private void initAd()
{
   // Создаем экземпляр InstreamAd
   ad = new InstreamAd(YOUR_SLOT_ID, this);
    
   // Устанавливаем плеер SDK
   ad.useDefaultPlayer(true);     // используется ExoPlayer, можно просто вызвать ad.useDefaultPlayer()
   // ad.useDefaultPlayer(false); // используется стандартный плеер Android SDK

   // Добавляем плеер на экран
   layout.addView(ad.getPlayer().getView());
}

private InstreamAd ad;

private void initAd()
{
   // Создаем экземпляр InstreamAd
   ad = new InstreamAd(YOUR_SLOT_ID, this);
    
   // Устанавливаем плеер
   MyAdPlayer appPlayer = new MyAdPlayer();

   ad.setPlayer(appPlayer);
}

class MyAdPlayer implements InstreamAdPlayer
{
   private @Nullable AdPlayerListener listener;

   private MyVideoPlayer myVideoPlayer;

   private void SomeMethod()
   {
       ...

       // При ошибках воспроизведения видео надо вызвать соответствующий метод слушателя.
       if (errorMessage != null && listener != null)
       {
           listener.onAdVideoError(errorMessage);
       }
   }

   private void OtherMethod()
   {
       ...

       // Когда воспроизведение видео завершилось, надо вызвать соответствующий метод слушателя.
       if (videoIsEnded && listener != null)
       {
           listener.onAdVideoCompleted();
       }
   }


   @Override
   public @Nullable AdPlayerListener getAdPlayerListener()
   {
       // Вернуть сохранённый слушатель плеера.

       return listener;
   }

   @Override
   public float getAdVideoDuration()
   {
       // Вернуть длительность рекламного видео.

       return myVideoPlayer.getDuration();
   }

   @Override
   public float getAdVideoPosition()
   {
       // Вернуть текущую позицию рекламного видео.
       // Метод вызывается многократно во время воспроизведения рекламного видео и должен отдавать актуальное значение в секундах.

       return myVideoPlayer.getPositionInSeconds();
   }

   @Override
   public @NonNull View getView()
   {
       // Визуальное представление плеера, обычно this.

       return myVideoPlayer.getView();
   }

   @Override
   public void setAdPlayerListener(@Nullable AdPlayerListener listener)
   {
       // Сохранить слушатель плеера.

       this.listener = listener;
   }

   @Override
   public void playAdVideo(@NonNull Uri uri, int width, int height)
   {
       // Начать воспроизведение рекламного видео.
       //      uri - путь к видео
       //      width - ширина видео в пикселях
       //      height - высота видео в пикселях

       // Начать воспроизведение в другом потоке, чтобы не блокировать SDK.
       someExecutor.execute(() -> {

           ...

           // Когда воспроизведение начнётся успешно, надо вызвать соответствующий метод слушателя.
           if (listener != null)
           {
               listener.onAdVideoStarted();
           }
       });
   }

   @Override
   public void playAdVideo(@NonNull Uri uri, int width, int height, float position)
   {
       // Начать воспроизведение рекламного видео.
       //      uri - путь к видео
       //      width - ширина видео в пикселях
       //      height - высота видео в пикселях
       //      position - начать с этой позиции. Используется после swap

       // Начать воспроизведение в другом потоке, чтобы не блокировать SDK.
       someExecutor.execute(() -> {

           ...

           // Когда воспроизведение начнётся успешно, надо вызвать соответствующий метод слушателя.
           if (listener != null)
           {
               listener.onAdVideoStarted();
           }
       });
   }

   @Override
   public void pauseAdVideo()
   {
       // Приостановить воспроизведение рекламного видео.

       // Начать паузу в другом потоке, чтобы не блокировать SDK.
       someExecutor.execute(() -> {

           ...

           // Когда воспроизведение успешно станет на паузу, надо вызвать соответствующий метод слушателя.
           if (listener != null)
           {
               listener.onAdVideoPaused();
           }
       });
   }

   @Override
   public void resumeAdVideo()
   {
       // Продолжить воспроизведение рекламного видео.

       // Продолжить в другом потоке, чтобы не блокировать SDK.
       someExecutor.execute(() -> {

           ...

           // Когда воспроизведение успешно продолжится, надо вызвать соответствующий метод слушателя.
           if (listener != null)
           {
               listener.onAdVideoResumed();
           }
       });
   }

   @Override
   public void stopAdVideo()
   {
       // Остановить воспроизведение рекламного видео.

       // Останавливаем в другом потоке, чтобы не блокировать SDK.
       someExecutor.execute(() -> {

           ...

           // Когда воспроизведение будет успешно остановлено, надо вызвать соответствующий метод слушателя.
           if (listener != null)
           {
               listener.onAdVideoStopped();
           }
       });
   }

   @Override
   public void destroy()
   {
       // Закрыть все сетевые подключения, освободить ресурсы.
   }

   @Override
   public void setVolume(float volume)
   {
       // Изменить громкость, от 0.0 до 1.0.

       // Изменяем громкость в другом потоке, чтобы не блокировать SDK.
       someExecutor.execute(() -> {

           ...

           // Когда громкость будет изменена успешно, надо вызвать соответствующий метод слушателя.
           if (listener != null)
           {
               listener.onVolumeChanged(volume);
           }
       });
   }
}

private InstreamAd ad;

private void initAd()
{
   // Создаем экземпляр InstreamAd
   ad = new InstreamAd(YOUR_SLOT_ID, this);
    
   // Устанавливаем плеер
   ad.setPlayer(YOUR_PLAYER);
   // Устанавливаем videoMotion-плеер
   ad.setVideoMotionPlayer(YOUR_VIDEO_MOTION_PLAYER)
}

private InstreamAd ad;

private void initAd()
{
   // Создаем экземпляр InstreamAd
   ad = new InstreamAd(YOUR_SLOT_ID, context);

   // Обязательно устанавливаем слушатель событий
   ad.setListener(new InstreamAd.InstreamAdListener()
   {
       @Override
       public void onLoad(InstreamAd instreamAd)
       {
           // Данные успешно загружены.
           // Можно отображать рекламу на экране.
       }

       @Override
       public void onNoAd(IAdLoadingError adLoadingError, InstreamAd instreamAd)
       {
           // Данные не получены
       }

       @Override
       public void onError(String reason, InstreamAd ad)
       {
           // При проигрывании рекламного видео произошла ошибка
       }

       @Override
       public void onBannerStart(InstreamAd ad, InstreamAd.InstreamAdBanner instreamAdBanner)
       {
           // Началось проигрывание рекламного видео
       }

       @Override
       public void onPostViewStart()
       {
           // Началось проигрывание пост-вью
       }

       @Override
       public void onVideoMotionBannerStart(
           InstreamAd ad,
           InstreamAd.InstreamAdVideoMotionBanner instreamAdVideoMotionBanner)
       {
           // Началось проигрывание videoMotion-баннера
       }

       @Override
       public void onVideoMotionBannerComplete(
           @NonNull InstreamAd ad,
           @NonNull InstreamAd.InstreamAdVideoMotionBanner banner)
       {
           // Видео для motion banner завершилось
       }

       @Override
       public void onBannerPause(InstreamAd ad, InstreamAd.InstreamAdBanner instreamAdBanner)
       {
           // Проигрывание рекламного видео приостановлено
       }

       @Override
       public void onBannerResume(InstreamAd ad, InstreamAd.InstreamAdBanner instreamAdBanner)
       {
           // Проигрывание рекламного видео возобновлено
       }

       @Override
       public void onPostViewComplete()
       {
           // Пост-вью завершилось
       }

       @Override
       public void onBannerComplete(InstreamAd ad, InstreamAd.InstreamAdBanner instreamAdBanner)
       {
           // Проигрывание рекламного видео завершено
       }

       @Override
       public void onBannerTimeLeftChange(float timeLeft, float duration, InstreamAd ad)
       {
           // Вызывается многократно во время воспроизведения рекламного видео,
           // используется для обновления таймера до окончания показа рекламного видео
       }

       @Override
       public void onComplete(String section, InstreamAd ad)
       {
           // Проигрывание всех рекламных видео в рекламной секции завершено
       }

       @Override
       public void onBannerShouldClose()
       {
           // Вызывается в момент выбора соответствующей опции из меню adChoices, например "Пожаловаться".
           // В этот момент контент нужно скрыть. Необходимо вызвать ad.skip метод.
       }

       @Override
       public void onVideoMotionBannerShouldClose(
           @NonNull InstreamAd ad,
           @NonNull InstreamAd.InstreamAdVideoMotionBanner banner)
       {
           // Вызывается в момент выбора соответствующей опции из меню adChoices, например "Пожаловаться".
           // В этот момент контент нужно скрыть. Необходимо вызвать videoMotionPlayerListener.onCloseByUser() метод.
       }
   });

   // Запускаем загрузку данных
   ad.load();
}

// Перед началом показа основного видео
ad.startPreroll();
 
// После показа основного видео
ad.startPostroll();

private InstreamAd ad;
private float videoDuration;

private void initAd()
{
   // Создаем экземпляр InstreamAd
   ad = new InstreamAd(YOUR_SLOT_ID, context);

   // Устанавливаем позиции на первой и пятой секунде видео
   ad.configureMidpoints(videoDuration, new float[]{ 5.0f, 15.0f });
   // или в процентах, на 10% и 50% видео
   // ad.configureMidpointsPercents(videoDuration, new float[] { 10.0f, 50.0f });

   // Устанавливаем слушатель событий
   ad.setListener(new InstreamAd.InstreamAdListener()
   {
       @Override
       public void onLoad(InstreamAd instreamAd)
       {
           // Данные успешно загружены
           // Массив позиций (в секундах), доступных для показа midroll секции
           adPositions = ad.getMidPoints();
       }

       @Override
       public void onNoAd(@NonNull IAdLoadingError adLoadingError, @NonNull InstreamAd ad)
       {
           // В этом объекте InstreamAd рекламы не будет
       }

       ... // прочие методы интерфейса InstreamAd.InstreamAdListener
   });

   // Запускаем загрузку данных
   ad.load();
}

// В случае успешной загрузки рекламы следует получить список мидпойнтов
// В нашем примере здесь будет две точки - на 5 и на 25 секунд
float[] midPoints = ad.getMidPoints();

// Играется основное видео

// Через 5 секунд воспроизведения видео начинаем первый мидролл
// (этот код следует вызывать асинхронно, здесь показано только для примера)
ad.startMidroll(midPoints[0]);

// Это метод приложения, который обрабатывает клики в инстрим-рекламе
private void onAdClick()
{
   // ad - это объект InstreamAd
   ad.handleClick();
}

// Приостанавливает проигрывание рекламного видео.
public void pause()

// Возобновляет проигрывание рекламного видео.
public void resume()

// Останавливает показ рекламной секции.
public void stop()

// Останавливает показ рекламной секции, если это было сделано пользователем
// (нажатие на кнопку "Пропустить" или "Закрыть").
public void skip()

// Останавливает текущее рекламное видео и переходит к следующему,
// если это было сделано пользователем (нажатие на кнопку "Пропустить" или "Закрыть").
public void skipBanner()

// Устанавливает громкость от 0 до 1.
public void setVolume(float volume)

// Устанавливает таймаут на загрузку рекламы в секундах.
// В случае, если по истечению указанного интервала не удалось получить баннеры,
// будет вызван коллбек onNoAd.
// Значение по-умолчанию 10 секунд, минимальное значение - 5 секунд.
public void setLoadingTimeout(int loadingTimeout)

class InstreamAdBanner
{
   // Длительность текущего рекламного видео в секундах.
   public final float duration;

   // Разрешено ли закрывать рекламное видео во время проигрывания.
   // Используется для управления показом кнопки "Закрыть" или "Пропустить".
   public final boolean allowClose;

   // Время в секундах, через которое рекламное видео может быть закрыто.
   // Используется для управления показом кнопки "Закрыть" или "Пропустить".
   public final float allowCloseDelay;

   // Ширина рекламного видео.
   public final int videoWidth;

   // Высота рекламного видео.
   public final int videoHeight;

   // Моделька для описания CTA - текст, цвета и так далее.
   // Например, callToACtionData.getButtonText() можно использовать,
   // чтобы получить текст для кнопки.
   public final @NotNull CallToActionData callToActionData;

   // Флаг аличия адчойсов.
   public final boolean hasAdChoices;

   // Рекламный заголовок.
   public final @NonNull String advertisingLabel;

   // Иконка адчойса
   public final @Nullable ImageData adChoicesIcon;

   ... // Прочие свойства инстрим-баннера
}

customAdChoicesView.setOnClickListener(v ->
   {
       ad.handleAdChoicesClick(context);
   });

MenuFactory menuFactory = new MenuFactory()
{
   @Override
   @NonNull public Menu createMenu()
   {
       return new Menu()
       {
           @Override
           public void setListener(@Nullable Listener listener)
           {
               // Слушатель, у которого нужно вызвать метод onActionClick(menuAction)
               // при нажатии на тот элемент UI, который был отрисован с соответствующим
               // заголовком menuAction
           }

           @Override
           public void addAction(@NonNull MenuAction menuAction)
           {
               // Это объект который содержит в себе заголовок и тип опции адчойсов,
               // а также другие атрибуты отдельных пунктов меню адчойсов.
               // Эти menuItem нужно нужно использовать при отрисовке пунктов меню.
           }

           @Override
           public void addAboutCompanyInfo(@NonNull String aboutCompanyInfo)
           {
               // Пвседопункт меню, в котором отображается информация о рекламируемой компании
               // Обычно находится в верхней части меню адчойсов
           }

           @Override
           public void present(@NonNull Context context)
           {
               // Данный метод вызывается когда необходимо отобразить меню
               // адчойсов с теми menuAction, которые были ранее переданы в вызовах
               // метода addAction(MenuAction)
           }

           @Override
           public void dismiss()
           {
               // Данный метод вызывается когда необходимо скрыть меню адчойсов
           }
       };
   }
};

...
ad = new InstreamAd(YOUR_SLOT_ID, menuFactory, this);
ad.load();

public class QrCta
{
   public final @NonNull ImageData qrImage;     // Картинка Qr-кода
   public final @Nullable QrIcon qrIcon;        // Иконка, расположенная поверх Qr-кода. Имеет свою собственную позицию
   public final @Nullable ImageData additionalImage; // Доплнительная рекламная картинка
   public final @NonNull String title;          // Текст заголовка
   public final @NonNull String additionalText; // Дополнительный текст
   public final @NonNull Position position;     // Позиция View Qr-кода на экране
   public final @ColorScheme int colorScheme;   // Цветовая схема.
                                                // Возможные значения @ColorScheme: WHITE | BLUE | TURQUOISE | GREEN | YELLOW | RED | PINK | PURPLE
}

public class QrIcon
{
   public final @NonNull ImageData iconImage; // Картинка иконки
   public final @NonNull Position position;   // Позиция иконки в рамках Qr-кода
}

public class Position
{
   public final @HorizontalPosition int horizontalPosition; // Возможные значения @HorizontalPosition: LEFT, CENTER, RIGHT
   public final @VerticalPosition int verticalPosition;     // Возможные значения @VerticalPosition: TOP, CENTER, BOTTOM
}

public class CustomQrCtaPlayer extends QrCtaPlayer
{
   @Override
   public void show(@NonNull QrCta qrCta)
   {
       // В методе show выполняется вся необходимая работа от создания,
       // до добавления View QR-кода в иерархию вьюшек для отображения на экране
       QrCtaView qrCtaView = new QrCtaView(context);

       // Кроме того, приложение может расположить вьюшку QR-кода на экране, руководствуясь QrCta::position.
       FrameLayout.LayoutParams params = new FrameLayout.LayoutParams(WRAP_CONTENT, WRAP_CONTENT);
       // Необходимо рассчитать Gravity в соответствии с Position, указанной в QrCta
       params.gravity = calculateGravityByPosition(qrCta.position);
       qrCtaView.setLayoutParams(params);

       qrCtaView.setQrCta(qrCta);

       rootView.addView(qrCtaView);
   }

   @Override
   public void hide()
   {
       // Вьюшку QR-кода можно скрыть или удалить
       rootView.removeAllViews();
   }

   private int calculateGravityByPosition(Position position)
   {
       final int verticalGravity;

       switch (position.verticalPosition)
       {
           case Position.VerticalPosition.TOP:
               verticalGravity = Gravity.TOP;
               break;
           case Position.VerticalPosition.CENTER:
               verticalGravity = Gravity.CENTER_VERTICAL;
               break;
           default:
               verticalGravity = Gravity.BOTTOM;
               break;
       }

       final int horizontalGravity;

       switch (position.horizontalPosition)
       {
           case Position.HorizontalPosition.LEFT:
               horizontalGravity = Gravity.START;
               break;
           case Position.HorizontalPosition.CENTER:
               horizontalGravity = Gravity.CENTER_HORIZONTAL;
               break;
           default:
               horizontalGravity = Gravity.END;
               break;
       }

       return verticalGravity | horizontalGravity;
   }
}

instreamAd.setQrCtaPlayer(new CustomQrCtaPlayer());

QrCtaView qrCtaView = new QrCtaView(context);

qrCtaView.setQrCtaTitleTextStyle(R.style.style_title_text);
qrCtaView.setQrCtaAdditionalTextStyle(R.style.style_additional_text);

public interface InstreamAdVideoMotionPlayer
{
   // Проиграть video motion баннер.
   void playVideoMotionBanner(InstreamAdVideoMotionBanner instreamAdVideoMotionBanner);

   // VideoMotionPlayerListener - интерфейс, методы которого следует вызывать после
   // выполнения соответствующих действий при воспроизведении instreamAdVideoMotionBanner
   void setVideoMotionPlayerListener(VideoMotionPlayerListener videoMotionPlayerListener);
}

interface VideoMotionPlayerListener
{
   // Метод должен быть вызван после успешного показа баннера.
   void onBannerShow(final @NonNull Context context);

   // Метод должен быть вызван при завершении показа баннера.
   void onBannerComplete(final @NonNull Context context);

   // Метод должен быть вызван при клике на заголовок баннера.
   void onHeaderClick(final @NonNull Context context);

   // Метод должен быть вызван после показа карточки с идентификатором itemId.
   void onItemShow(final @NonNull String id, final @NonNull Context context);

   // Метод должен быть вызван при клике по карточке с идентификатором itemId.
   void onItemClick(final @NonNull String id, final @NonNull Context context);

   // Метод должен быть вызван при возникновении какой-либо ошибки.
   void onError(final @NonNull String message, final @NonNull Context context);

   // Метод должен быть вызван при закрытии баннера пользователем.
   void onCloseByUser(final @NonNull Context context);
}

class InstreamAdVideoMotionBanner
{
   // Модель данных (см. ниже).
   public final @NonNull VideoMotionData videoMotionData;

   // Флаг, разрешающий пропускать баннер.
   public final boolean allowClose;

   // Время в секундах, через которое баннер может быть пропущен.
   public final float allowCloseDelay;

   // Длительность video motion баннера.
   public final float duration;

   // Иконка adChoices.
   public final boolean hasAdChoices;

   // Флаг, сообщающий что у баннера есть adChoices.
   public final @Nullable ImageData adChoicesIcon;
}

class VideoMotionData
{
   // Заголовок баннера.
   public final @NonNull Header header;

   // Массив карточек.
   public final @NonNull List<VideoMotionItem> videoMotionItemList;

   // Дисклеймер.
   public final @Nullable Disclaimer disclaimer;
}

class Header
{
   // УРЛ иконки.
   public final @NonNull String icon;

   // Заголовок.
   public final @NonNull String title;

   // Текстовая ссылка.
   public final @NonNull String linkText;

   // Возрастное ограничение.
   public final @NonNull String ageRestrictionText;

   // Дисклеймер "реклама".
   public final @NonNull String adDisclaimerText;
}

class VideoMotionItem
{
   // Идентификатор карточки.
   public final @NonNull String id;

   // Цена новая.
   public final @Nullable String price;

   // Цена старая.
   public final @Nullable String oldPrice;

   // Валюта.
   public final @NonNull String currency;

   // Картинка.
   public final @NonNull String image;

   // Описание.
   public final @NonNull String text;

   // Текст для кнопки.
   public final @NonNull String ctaText;
}

class Disclaimer
{
   // Текстовое описание.
   public final @NonNull String text;
}