Charger des annonces pré-roll pour une diffusion en direct

Sélectionnez une plate-forme : HTML5 Android iOS tvOS

Le SDK IMA peut être utilisé pour monétiser les flux en direct et les vidéos à la demande. Pour les diffusions en direct, vous devez envoyer une nouvelle demande d'annonce pour chaque coupure publicitaire. Échelonnez ces demandes pour vous assurer que tous vos spectateurs ne demandent pas d'annonces en même temps, ce qui pourrait ralentir le ou les serveurs publicitaires.

Pour vous aider, le SDK IMA dispose de la propriété AdsRequest.liveStreamPrefetchSeconds. Cette propriété spécifie le nombre maximal de secondes pendant lesquelles le SDK doit patienter avant de contacter le serveur publicitaire après l'appel de AdsLoader.requestAds(). L'heure de la demande réelle sera aléatoire. Par exemple, si vous définissez AdsRequest.liveStreamPrefetchSeconds sur 30, le SDK attend entre 0 et 30 secondes après l'appel de AdsLoader.requestAds() pour envoyer la requête au serveur.

Préchargement des diffusions en direct en pratique

Nous vous recommandons de précharger votre prochaine série d'annonces dès qu'une série d'annonces se termine. Cela garantit la durée maximale disponible pour votre fenêtre de préchargement. Imaginons que vous ayez cinq minutes entre les coupures publicitaires. Une fois la coupure publicitaire terminée, vous pouvez demander la suivante avec une fenêtre de préchargement de 290 secondes (5 minutes moins 10 secondes, pour vous assurer que les demandes envoyées à la fin de la fenêtre de préchargement ont suffisamment de temps pour être traitées) :

Point clé : Le guide de démarrage et l'exemple de base implémentent tous deux l'extension ExoPlayer-IMA, qui gère la configuration de AdsManager. Par conséquent, ces ressources ne peuvent pas être utilisées comme point de départ pour ce guide. Nous vous recommandons d'utiliser l'exemple avancé comme point de départ pour le préchargement des diffusions en direct.

Ces extraits de code montrent comment ajouter la prélecture des diffusions en direct à l'exemple avancé, mais l'approche peut être appliquée à d'autres implémentations 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);
}