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

Le SDK IMA permet de monétiser des diffusions en direct ainsi que des 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 les spectateurs n'en font pas tous des annonces en même temps et qui ralentissent le ou les serveurs publicitaires.

Pour vous aider, le SDK IMA inclut l'AdsRequest.liveStreamPrefetchSeconds . Cette propriété spécifie le nombre maximal de secondes pendant lequel le SDK doit attendre avant de contacter l'ad server après l'appel AdsLoader.requestAds() L'heure réelle de la requête sera aléatoire. Pour Par exemple, si vous définissez AdsRequest.liveStreamPrefetchSeconds sur 30, le SDK attend 0 à 30 secondes après l'appel de AdsLoader.requestAds() pour envoie la requête au serveur.

Le préchargement des diffusions en direct dans la pratique

Nous vous recommandons de précharger la prochaine coupure publicitaire dès qu'elle se termine. Cela permet de garantir que la durée maximale est disponible pour votre fenêtre de préchargement. Imaginons que vous ayez cinq minutes entre chaque coupure publicitaire. À la fin d'une coupure publicitaire, vous pouvez demander votre prochaine coupure publicitaire avec une fenêtre de préchargement de 290 secondes (5 minutes moins 10 secondes, pour s'assurer que les requêtes envoyées à la fin de la fenêtre de préchargement disposent de suffisamment de temps pour se résoudre):

Important: Le Guide de démarrage et Exemple de base implémentent toutes les deux Extension Exoplayer-IMA qui gère la configuration d'AdsManager. Pour cette raison, ces ressources ne sont pas peuvent servir de point de départ pour ce guide. Nous vous recommandons d'utiliser Exemple avancé comme point de départ pour le préchargement des diffusions en direct.

Ces extraits de code montrent comment ajouter le préchargement des diffusions en direct à la Exemple avancé , mais cette approche peut s'appliquer à d'autres implémentations d'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);
}