Ręczne odtwarzanie przerwy na reklamę

W tym przewodniku znajdziesz instrukcje zastępowania domyślnego harmonogramu przerw na reklamę i konfigurowania własnych czasów odtwarzania przerw na reklamę. 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. Poinformuj pakiet SDK, że chcesz sterować odtwarzaniem 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 do implementacji ręcznego odtwarzania 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 w przypadku implementacji 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.