Pré-carregar intervalos comerciais para transmissões

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. Para transmissões ao vivo, você precisa fazer uma nova solicitação de anúncio para cada intervalo de anúncio. 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 esperar de 0 a 30 segundos depois que você chamar AdsLoader.requestAds() para fazer a solicitação ao servidor.

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

Recomendamos pré-buscar o próximo intervalo de anúncio assim que um intervalo de anúncio terminar. Isso garante que o período máximo esteja disponível para sua janela de pré-busca. Suponha que você tenha 5 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):

Importante: o guia para iniciantes e o exemplo básico implementam a extensão Exoplayer-IMA que lida com a configuração do AdsManager. Por isso, esses recursos não podem ser usados como ponto de partida para este guia. Recomendamos usar o Exemplo avançado como ponto de partida para a pré-busca de transmissões ao vivo.

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