Lecture manuelle des coupures publicitaires

Ce guide explique comment remplacer la planification par défaut des coupures publicitaires et configurer vos propres temps de lecture. 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 est chargée et attend que vous lanciez la lecture.

Conditions préalables

• 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 nécessaires à l'exemple avancé pour implémenter la lecture manuelle des coupures publicitaires.

Important :L'exemple de base implémente l'extension Exoplayer-IMA qui gère la configuration des paramètres ImaSdkSettings et AdEvents. De ce fait, 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 nécessaire pour l'implémentation du SDK IMA ?

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