Prélecture des diffusions 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.

Remarque :Pour voir un exemple de préchargement terminé de diffusion en direct, consultez notre Exemple GitHub.

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):

// 5 minutes == 300 seconds. Include a 10 second buffer
var AD_INTERVAL = 290;

function onAdEvent(adEvent) {
  var ad = adEvent.getAd();
  switch(adEvent.type) {
    case google.ima.AdEvent.Type.ALL_ADS_COMPLETED:
      // Pre-fetch our next ad break.
      requestAds();
      // Play those ads in 5 minutes. In a real-world implementation,
      // this is likely done as the result of a message from your
      // streaming server, not a timeout.
      setTimeout(playAds, AD_INTERVAL * 1000);// Convert to ms.
  }
}

function requestAds() {
  // Destroy the current AdsManager, in case the tag you requested previously
  // contains post-rolls (don't play those now).
  if (adsManager) {
    adsManager.destroy();
  }
  // Your AdsLoader will be set up on page-load. You should re-use the same
  // AdsLoader for every request. For more info on setting up the AdsLoader,
  // see the "Get Started" guide in the prerequisites above.
  if (adsLoader) {
    // Reset the IMA SDK.
    adsLoader.contentComplete();
  }
  var adsRequest = new google.ima.AdsRequest();
  adsRequest.adTagUrl = '...';
  adsRequest.linearAdSlotWidth = <linear_width>;
  adsRequest.linearAdSlotHeight = <linear_height>;
  adsRequest.nonLinearAdSlotWidth = <nonlinear_width>;
  adsRequest.nonLinearAdSlotHeight = <nonlinear_height>;
  adsRequest.liveStreamPrefechSeconds = AD_INTERVAL;
  adsLoader.requestAds(adsRequest);
}

function playAds() {
  adsManager.init(
      <linear_width>,  <linear_height>, google.ima.ViewMode.NORMAL);
  adsManager.start();
}