Carregar anúncios precedentes para a transmissão ao vivo

Selecione a plataforma: HTML5 Android iOS tvOS

O SDK do IMA pode ser usado para gerar receita com transmissões ao vivo e vídeo on demand. Nas transmissões ao vivo, é necessário fazer uma nova solicitação de anúncio para cada intervalo. Faça isso para garantir que todos os espectadores não estejam solicitando anúncios ao mesmo tempo e sobrecarregando os servidores de anúncios.

Para ajudar com isso, o SDK do IMA tem a propriedade AdsRequest.liveStreamPrefetchSeconds. Essa propriedade especifica o número máximo de segundos que o SDK deve esperar antes de entrar em contato com o servidor de anúncios depois que você chamar AdsLoader.requestAds(). O horário real da solicitação será aleatório. Por exemplo, se você definir AdsRequest.liveStreamPrefetchSeconds como 30, o SDK vai aguardar de 0 a 30 segundos depois que você chamar AdsLoader.requestAds() para fazer a solicitação ao servidor.

Observação: para ver um exemplo completo de pré-busca de transmissão ao vivo, confira nossa amostra do GitHub.

Pré-busca de transmissões ao vivo na prática

Recomendamos pré-buscar a próxima pausa assim que uma pausa para anúncio for concluída. Isso garante que o período máximo esteja disponível para sua janela de pré-busca. Suponha que você tenha cinco minutos entre os intervalos de anúncio. Quando um intervalo de anúncio é concluído, você pode solicitar o próximo com uma janela de pré-busca de 290 segundos (5 minutos menos 10 segundos, para garantir que as solicitações enviadas no final da janela de pré-busca tenham tempo suficiente para serem resolvidas):

// 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 IMA HTML5 client-side "Set up the IMA SDK" guide:
  // https://developers.google.com/interactive-media-ads/docs/sdks/html5/client-side/get-started
  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>);
  adsManager.start();
}