Precaricamento dei 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 modo scaglionato per garantire che tutti i visualizzatori non richiedano annunci contemporaneamente e non blocchino gli ad server.

A questo scopo, l'SDK IMA ha la proprietà AdsRequest.liveStreamPrefetchSeconds. Questa proprietà specifica il numero massimo di secondi che l'SDK deve attendere prima di contattare l'ad server dopo la chiamata a AdsLoader.requestAds(). L'ora effettiva della richiesta sarà casuale. Ad esempio, se imposti AdsRequest.liveStreamPrefetchSeconds su 30, l'SDK attende da 0 a 30 secondi dopo la chiamata a AdsLoader.requestAds() per effettuare effettivamente la richiesta al server.

Precaricamento del live streaming in pratica

Ti consigliamo di precaricare la prossima interruzione pubblicitaria al termine di un'interruzione pubblicitaria. In questo modo si assicura che sia disponibile la durata massima per la finestra di precaricamento. Supponiamo che ci siano 5 minuti di tempo tra un'interruzione pubblicitaria e l'altra. Al completamento di un'interruzione pubblicitaria, puoi richiedere l'interruzione pubblicitaria successiva con una finestra di precaricamento di 290 secondi (5 minuti meno 10 secondi, per assicurarti che le richieste inviate alla fine della finestra di precaricamento abbiano tempo sufficiente per essere risolte):

Punto chiave: la Guida introduttiva e l'Esempio di base implementano entrambi l'estensione Exoplayer-IMA che gestisce la configurazione di AdsManager. Per questo motivo, non puoi utilizzare queste risorse 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 del live streaming all'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 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);
}