Pré-carregar intervalos comerciais para transmissões

Selecione a plataforma: HTML5 Android iOS tvOS

O SDK do IMA pode ser usado para monetizar transmissões ao vivo e vídeos sob demanda. Para transmissões ao vivo, é necessário fazer uma nova solicitação de anúncio para cada intervalo de anúncio. Faça essas solicitações de forma escalonada para garantir que todos os espectadores não solicitem anúncios ao mesmo tempo e sobrecarreguem 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 aguardar antes de entrar em contato com o servidor de anúncios depois que você chamar AdsLoader.requestAds(). O tempo de solicitação real 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.

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

Recomendamos fazer a pré-busca do próximo intervalo de anúncio assim que um intervalo for concluído. Isso garante que o período máximo de tempo esteja disponível para a janela de pré-busca. Suponha que você tenha 5 minutos entre os intervalos de anúncio. 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 final da janela de pré-busca tenham tempo suficiente para serem resolvidas):

**Ponto-chave** :o guia de introdução e o exemplo básico implementam a extensão Exoplayer-IMA , que processa 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ão ao vivo.

Esses snippets de código mostram como adicionar a pré-busca de 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 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);
}