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

Esses snippets de código mostram como adicionar a pré-busca da transmissão ao vivo ao exemplo avançado, mas a abordagem pode ser aplicada a outras implementações do 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);
}