Pré-busca de transmissão ao vivo

O SDK do IMA pode ser usado para gerar receita com transmissões ao vivo e vídeos sob demanda. Em transmissões ao vivo, é necessário fazer uma nova solicitação de anúncio para cada intervalo. Equilibre essas solicitações para garantir que nem todos os espectadores solicitem anúncios ao mesmo tempo, sobrecarregando os servidores de anúncios.

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

Observação :para conferir um exemplo completo de pré-busca da transmissão ao vivo, confira nosso exemplo do GitHub (link em inglês).

Pré-busca da transmissão ao vivo na prática

Recomendamos que você faça a pré-busca do próximo intervalo de anúncio assim que ele terminar. Isso garante que o período máximo de tempo esteja disponível para sua janela de pré-busca. Digamos que você tenha 5 minutos entre os intervalos de anúncios. Quando um intervalo de anúncio for concluído, você poderá 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 fim desse período 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 "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();
}