Ręczne odtwarzanie przerwy na reklamę

Ten przewodnik zawiera instrukcje dotyczące zastępowania domyślnego harmonogramu przerw na reklamę i konfigurowania własnych czasów odtwarzania przerw na reklamę. Po zaimplementowaniu ręcznego odtwarzania przerwy na reklamę pakiet SDK uruchamia zdarzenie AD_BREAK_READY po wczytaniu reklamy i czeka na Ciebie, aby rozpocząć odtwarzanie 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 kontrolować odtwarzanie przerwy na reklamę.
  2. Wykrywaj zdarzenie AD_BREAK_READY.
  3. Poinformuj pakiet SDK, aby wyświetlał reklamy, gdy wszystko będzie gotowe.

Poniżej znajdziesz fragment kodu, który zawiera modyfikacje wymagane w przykładzie zaawansowanym na potrzeby 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 reklamy?
Nie. Ręczne odtwarzanie reklam jest opcjonalną funkcją dla wydawców, którzy nie chcą, aby pakiet IMA SDK automatycznie odtwarzał przerwy na reklamy zgodnie z harmonogramem określonym w regule reklamowej lub w odpowiedzi VMAP.