Riproduzione manuale dell'interruzione pubblicitaria

Questa guida fornisce istruzioni su come sostituire la pianificazione dell'interruzione pubblicitaria predefinita e configurare i tuoi tempi di riproduzione delle interruzioni pubblicitarie. Quando viene implementata la riproduzione manuale di un'interruzione pubblicitaria, l'SDK attiva un evento AD_BREAK_READY quando è stata 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 manuale delle interruzioni pubblicitarie:

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

Lo snippet riportato di seguito mostra le modifiche necessarie all'esempio avanzato per implementare la riproduzione manuale delle interruzioni pubblicitarie.

Punto chiave: l'Esempio di base implementa l'estensione Exoplayer-IMA, che gestisce la configurazione di ImaSdkSettings e AdEvents. Per questo motivo, non è possibile utilizzare l'esempio di base 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

Per l'implementazione dell'SDK IMA è necessaria la riproduzione manuale degli annunci?

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 programmato da una regola per gli annunci o da una risposta VMAP.