Ręczne odtwarzanie przerwy na reklamę

W tym przewodniku znajdziesz instrukcje dotyczące zastąpienia domyślnego harmonogramu przerw na reklamy i konfigurowania własnych ustawień czasu wyświetlania przerw na reklamy. Gdy wdrożona jest ręczna obsługa przerwy na reklamę, po załadowaniu przerwy na reklamę pakiet SDK uruchamia zdarzenie AD_BREAK_READY i czeka na rozpoczęcie odtwarzania przerwy.

Wymagania wstępne

  • Aplikacja na Androida z zaimplementowanym pakietem IMA SDK.

Konfigurowanie ręcznego odtwarzania przerwy na reklamę

Aby skonfigurować ręczne odtwarzanie przerwy na reklamę:

  1. Powiedz pakietowi SDK, że chcesz kontrolować odtwarzanie przerwy na reklamę.
  2. Nasłuchuj zdarzenie AD_BREAK_READY.
  3. Poinformuj pakiet SDK, aby wyświetlał reklamy, gdy będziesz gotowy.

Fragment kodu poniżej pokazuje modyfikacje wymagane w przykładzie zaawansowanym, aby wdrożyć ręczne odtwarzanie przerwy na reklamę.

public VideoPlayerController(
      Context context,
      VideoPlayerWithAdPlayback videoPlayerWithAdPlayback,
      View playButton,
      View playPauseToggle,
      String language,
      ViewGroup companionViewGroup,
      Logger log) {
  ...
  
  sdkFactory = ImaSdkFactory.getInstance();
  ImaSdkSettings imaSdkSettings = sdkFactory.createImaSdkSettings();
  imaSdkSettings.setLanguage(language);
  // Tell the SDK you want to control ad break playback.
  imaSdkSettings.setAutoPlayAdBreaks(false);
  
  ...
}
...
@Override
public void onAdEvent(AdEvent adEvent) {
    ...
    switch (adEvent.getType()) {
      // Listen for the AD_BREAK_READY event.
      case AD_BREAK_READY:
        // Tell the SDK to play ads when you're ready. To skip this ad break,
        // simply return from this handler without calling adsManager.start().
        adsManager.start();
        break;
      ...
}

Najczęstsze pytania

Czy do wdrożenia pakietu IMA SDK wymagane jest ręczne odtwarzanie reklam?
Nie. Odtwarzanie reklam ręcznie to opcjonalna funkcja dla wydawców, którzy nie chcą, aby pakiet IMA SDK automatycznie odtwarzał przerwy na reklamę zgodnie z harmonogramem określonym przez regułę reklamy lub odpowiedź VMAP.