Caricare gli annunci pre-roll per il live streaming

Seleziona la piattaforma: HTML5 Android iOS tvOS

L'SDK IMA può essere utilizzato per monetizzare sia i live streaming sia i video on demand. Per i live streaming, devi effettuare una nuova richiesta di annunci per ogni interruzione pubblicitaria. Scagliona queste richieste per assicurarti che tutti gli spettatori non richiedano annunci contemporaneamente e non sovraccarichino i server pubblicitari.

A questo scopo, l'SDK IMA ha la AdsRequest.liveStreamPrefetchSeconds proprietà. Questa proprietà specifica il numero massimo di secondi che l'SDK deve attendere prima di contattare il server pubblicitario dopo aver chiamato AdsLoader.requestAds(). Il tempo di richiesta effettivo verrà randomizzato. Ad esempio, se imposti AdsRequest.liveStreamPrefetchSeconds su 30, l'SDK attende da 0 a 30 secondi dopo aver chiamato AdsLoader.requestAds() per effettuare la richiesta al server.

Precaricamento dei live streaming in pratica

Ti consigliamo di precaricare la prossima interruzione pubblicitaria non appena ne viene completata una. In questo modo, la durata massima della finestra di precaricamento è disponibile. Supponiamo che tu abbia 5 minuti tra le interruzioni pubblicitarie. Quando un'interruzione pubblicitaria viene completata, puoi richiedere la successiva con una finestra di precaricamento di 290 secondi (5 minuti meno 10 secondi, per assicurarti che le richieste inviate alla fine di la finestra di precaricamento abbiano tempo sufficiente per essere risolte):

Punto chiave: La guida introduttiva e l' esempio di base implementano l' estensione Exoplayer-IMA che gestisce la configurazione di AdsManager. Per questo motivo, queste risorse non possono essere utilizzate come punto di partenza per questa guida. Ti consigliamo di utilizzare l' esempio avanzato come punto di partenza per il precaricamento dei live streaming.

Questi snippet di codice mostrano come aggiungere il precaricamento dei live streaming al l'esempio avanzato , ma l'approccio 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 through 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);
}