Riproduzione manuale dell'interruzione pubblicitaria

Questa guida fornisce istruzioni su come ignorare la pianificazione predefinita delle interruzioni pubblicitarie e configurare i tempi di riproduzione delle interruzioni pubblicitarie. Quando è implementata la riproduzione manuale delle interruzioni pubblicitarie, l'SDK attiva un evento AD_BREAK_READY quando viene caricata un'interruzione pubblicitaria e attende che tu avvii la riproduzione dell'interruzione.

Prerequisiti

• Un'applicazione Android con l'SDK IMA implementato.

Configurare la riproduzione manuale delle interruzioni pubblicitarie

Per configurare la riproduzione delle interruzioni pubblicitarie manuali:

1. Comunica all'SDK che vuoi controllare la riproduzione dell'interruzione pubblicitaria.
2. Ascolta l'evento AD_BREAK_READY.
3. Quando è tutto pronto, chiedi all'SDK di riprodurre gli annunci.

Lo snippet seguente mostra le modifiche necessarie all'esempio avanzato per implementare la riproduzione delle interruzioni pubblicitarie manuali.

Punto chiave: l'esempio di base implementa l'estensione Exoplayer-IMA che gestisce la configurazione di ImaSdkSettings e AdEvents. Per questo motivo, l'Esempio di base non può essere utilizzato come punto di partenza per questa guida.

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;
      ...
}

Domande frequenti

La riproduzione manuale degli annunci è obbligatoria per un'implementazione dell'SDK IMA?

No. La riproduzione manuale degli annunci è una funzionalità facoltativa per i publisher che non vogliono che l'SDK IMA riproduca automaticamente le interruzioni pubblicitarie come pianificato da una regola pubblicitaria o da una risposta VMAP.