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.

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

Objective-C


- (void)adsManager:(IMAAdsManager *)adsManager didReceiveAdEvent:(IMAAdEvent *)event {

  ...

  switch (event.type) {

    ...

    case kIMAAdEvent_ALL_ADS_COMPLETED:

      IMAAdsRequest *request = [[IMAAdsRequest alloc]
             initWithAdTagUrl: self.adTagUrl
           adDisplayContainer: self.adDisplayContainer
         avPlayerVideoDisplay: self.avPlayerVideoDisplay
        pictureInPictureProxy: self.pictureInPictureProxy
                  userContext: nil];

      // set a delay between the end of the last ad
      // in the last request, and the first ad from
      // the new request
      Float64 adGap = 30;
      // make sure the request occurs at least five
      // seconds before starting the new set of ads
      request.liveStreamPrefetchSeconds = adGap - 5;
      [self.adsLoader requestAdsWithRequest:request];
      // start new ads after adGap seconds have elapsed
      dispatch_after(dispatch_time(DISPATCH_TIME_NOW, adGap * NSEC_PER_SEC), dispatch_get_main_queue(), ^{
        [adsManager start];
      });

      break;

    ...

  }

  ...

}

Swift

func adsManager(_ adsManager: IMAAdsManager!, didReceive event: IMAAdEvent!) {
  switch event.type {

    ...

    case IMAAdEventType.ALL_ADS_COMPLETED:

      let request = IMAAdsRequest(
        adTagUrl: AdTagUrl,
        adDisplayContainer: adDisplayContainer,
        contentPlayhead: contentPlayhead,
        userContext: nil)

      // set a delay between the end of the last ad
      // in the last request, and the first ad from
      // the new request
      let adGap = 30
      // make sure the request occurs at least five
      // seconds before starting the new set of ads
      request.liveStreamPrefetchSeconds = adGap - 5
      adsLoader.requestAds(with: request)
      // start new ads after adGap seconds have elapsed
      DispatchQueue.main.asyncAfter(deadline: .now() + adGap) {
        adsManager.start()
      }

      break

    ...
  }
}