Caricare gli annunci pre-roll per il live streaming

L'SDK IMA può essere utilizzato per monetizzare i live streaming e i video on demand. Per i live streaming, devi effettuare una nuova richiesta di annuncio per ogni interruzione pubblicitaria. Distribuite queste richieste in più scaglioni per evitare che tutti gli spettatori lo facciano contemporaneamente gli annunci e il traffico degli ad server.

Per aiutarti, l'SDK IMA include l'AdsRequest.liveStreamPrefetchSeconds proprietà. Questa proprietà specifica il numero massimo di secondi in cui l'SDK devi attendere prima di contattare l'ad server dopo la chiamata AdsLoader.requestAds(). L'ora effettiva della richiesta verrà casuale. Per Ad esempio, se imposti AdsRequest.liveStreamPrefetchSeconds su 30, l'SDK attende da 0 a 30 secondi dopo la chiamata a AdsLoader.requestAds() per inviare la richiesta al server.

Precaricamento del live streaming in pratica

Ti consigliamo di precaricare la tua prossima interruzione pubblicitaria non appena viene completata. In questo modo ti assicuri che sia disponibile il periodo di tempo massimo per la finestra di precaricamento. Supponiamo che trascorri 5 minuti tra un'interruzione pubblicitaria e l'altra. Quando viene completata un'interruzione pubblicitaria, puoi richiedere la prossima interruzione pubblicitaria con una finestra di precaricamento di 290 secondi (5 minuti meno 10 secondi, per garantire che le richieste inviate alla fine la finestra di precaricamento abbia tempo sufficiente per risolversi):

Punto chiave: il Guida introduttiva e ai Esempio di base entrambi implementano Estensione IMA Exoplayer che gestisce la configurazione di AdsManager. Per questo motivo, queste risorse non sono possono essere utilizzati come punto di partenza per questa guida. Ti consigliamo di utilizzare Esempio avanzato come punto di partenza per il precaricamento del live streaming.

Questi snippet di codice mostrano come aggiungere il precaricamento del live streaming al Esempio avanzato , ma può essere applicato ad altre implementazioni IMA.

VideoPlayerController.java

/** Ads logic for handling the IMA SDK integration code and events. */
public class VideoPlayerController {

  // 5 minutes == 300 seconds. Include a 10 second buffer
  private float AD_INTERVAL = 290;
  private double AD_TIMEOUT = 300;

...

  adsManager.addAdEventListener(
    new AdEvent.AdEventListener() {
      /** Responds to AdEvents. */
      @Override
      public void onAdEvent(AdEvent adEvent) {

      ...

      case ALL_ADS_COMPLETED:
        if (adsManager != null) {
          adsManager.destroy();
          adsManager = null;
        }

        // When pre-fetching for live streams, be sure to destroy the current AdsManager,
        // in case the tag you requested previously contains post-rolls
        // (you don't want to play those now).

        // Pre-fetch the next ad break.
        // Play those ads in ~5 minutes. In a real-world implementation,
        // this will likely be done as the result of a message from your
        // streaming server, not a via the playAdsAfterThisTime parameter
        // of requestAndPlayAds().
        requestAndPlayAds(AD_TIMEOUT);
        break;
      default:
        break;
      }
  }

...

public void requestAndPlayAds(double playAdsAfterThisTime) {
  if (currentAdTagUrl == null || currentAdTagUrl == "") {
    log("No VAST ad tag URL specified");
    resumeContent();
    return;
  }

  // Since you're switching to a new video, tell the SDK the previous video is finished.
  if (adsManager != null) {
    adsManager.destroy();
  }

  playButton.setVisibility(View.GONE);

  // Create the ads request.
  AdsRequest request = sdkFactory.createAdsRequest();
  request.setAdTagUrl(currentAdTagUrl);
  request.setContentProgressProvider(videoPlayerWithAdPlayback.getContentProgressProvider());
  request.setLiveStreamPrefetchSeconds(AD_INTERVAL);

  playAdsAfterTime = playAdsAfterThisTime;

  // Request the ad. After the ad is loaded, onAdsManagerLoaded() will be called.
  adsLoader.requestAds(request);
}