IMA Android SDK поддерживает полностью автоматизированные списки воспроизведения объявлений. Эта функция вставляет рекламные паузы в контент, как указано в Google Ad Manager , при размещении ваших объявлений. Это также значительно упрощает код видеопроигрывателя, необходимый для поддержки рекламных пауз, включая предварительные, средние и конечные ролики.
- При размещении объявлений в Менеджере рекламы можно указать различные правила для объявлений, такие как «всегда воспроизводить рекламную паузу в начале контента» или «играть одну минуту рекламной паузы каждые 30 минут контента».
- Когда реклама запрашивается, рекламный сервер может вернуть список воспроизведения рекламы. SDK обрабатывает список воспроизведения и автоматически планирует указанные рекламные паузы.
- Поскольку Android использует один и тот же видеоплеер для воспроизведения рекламы и контента, если вы планируете применять правила для рекламы, вы должны сохранить положение точки воспроизведения вашего контента при запуске рекламы, а затем перейти к этой позиции, когда реклама закончится. Обязательно реализуйте интерфейс
VideoAdPlayer
в своем видеоплеере. Это гарантирует, что рекламные паузы автоматически вставляются в моменты времени, указанные в Менеджере рекламы.private boolean playingContent = true; private int contentPosition = -1; private List
callbacks = new ArrayList (); @Override public void addCallback(VideoAdPlayerCallback callback) { callbacks.add(callback); } @Override public void removeCallback(VideoAdPlayerCallback callback) { callbacks.remove(callback); } public void loadContent() playingContent = true; load(CONTENT_URL); } @Override public void loadAd(String mediaUrl) { playingContent = false; load(mediaUrl); } public void pauseContent() { savePosition(); pause(); } @Override public void pauseAd() { pause(); } private void pause() { myVideoView.pause(); for (VideoAdPlayerCallback callback : callbacks) { callback.onPause(); } } public void resumeContent() { loadContent(); if (contentPosition > 0) { restorePosition(); } resume(); } @Override public void resumeAd() { resume(); } private void resume() { myVideoView.start(); for (VideoAdPlayerCallback callback : callbacks) { callback.onResume(); } } public void savePosition() { contentPosition = myVideoView.getCurrentPosition(); } public void restorePosition() { myVideoView.seekTo(contentPosition); } - События
CONTENT_PAUSE_REQUESTED
иCONTENT_RESUME_REQUESTED
используются для приостановки и возобновления контента при воспроизведении рекламных пауз. Дополнительные сведения об этих событиях см. в соответствующей документации API .
Примечание. Когда содержимое закончило воспроизведение или пользователь остановил воспроизведение, обязательно вызовите AdsLoader.contentComplete , чтобы сообщить SDK, что содержимое готово. Затем SDK воспроизводит рекламную паузу после ролика, если она была запланирована. Событие ALL_ADS_COMPLETED
возникает, когда сыграны ВСЕ рекламные паузы. Кроме того, обратите внимание, что отслеживание контента начинается при вызове init( init()
, и вы всегда должны вызывать init()
перед воспроизведением контента.