Lecture manuelle des coupures publicitaires

Ce guide explique comment remplacer le calendrier de diffusion des coupures publicitaires par défaut et configurer vos propres temps de lecture des coupures publicitaires. Lorsque la lecture manuelle des coupures publicitaires est implémentée, le SDK déclenche un événement AD_BREAK_READY lorsqu'une coupure publicitaire a été chargée et attend que vous démarriez la lecture de la coupure.

Prérequis

• Une application Android avec le SDK IMA implémenté.

Configurer la lecture manuelle des coupures publicitaires

Pour configurer la lecture manuelle des coupures publicitaires:

1. Indiquez au SDK que vous souhaitez contrôler la lecture des coupures publicitaires.
2. Écoutez l'événement AD_BREAK_READY.
3. Demandez au SDK de diffuser des annonces lorsque vous êtes prêt.

L'extrait de code ci-dessous montre les modifications requises pour l'exemple avancé afin d'implémenter la lecture manuelle des coupures publicitaires.

Point clé :L'exemple de base implémente l'extension Exoplayer-IMA, qui gère la configuration d'ImaSdkSettings et d'AdEvents. Par conséquent, l'exemple de base ne peut pas être utilisé comme point de départ de ce guide.

public VideoPlayerController(
      Context context,
      VideoPlayerWithAdPlayback videoPlayerWithAdPlayback,
      View playButton,
      View playPauseToggle,
      String language,
      ViewGroup companionViewGroup,
      Logger log) {
  ...
  
  sdkFactory = ImaSdkFactory.getInstance();
  ImaSdkSettings imaSdkSettings = sdkFactory.createImaSdkSettings();
  imaSdkSettings.setLanguage(language);
  // Tell the SDK you want to control ad break playback.
  imaSdkSettings.setAutoPlayAdBreaks(false);
  
  ...
}
...
@Override
public void onAdEvent(AdEvent adEvent) {
    ...
    switch (adEvent.getType()) {
      // Listen for the AD_BREAK_READY event.
      case AD_BREAK_READY:
        // Tell the SDK to play ads when you're ready. To skip this ad break,
        // simply return from this handler without calling adsManager.start().
        adsManager.start();
        break;
      ...
}

Questions fréquentes

La lecture manuelle des annonces est-elle requise pour l'implémentation d'un SDK IMA ?

Non. La lecture manuelle des annonces est une fonctionnalité facultative pour les éditeurs qui ne souhaitent pas que le SDK IMA diffuse automatiquement les coupures publicitaires comme prévu par une règle d'annonce ou une réponse VMAP.