Lecture manuelle des coupures publicitaires

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

Conditions préalables

• Une application Android dans laquelle le SDK IMA est 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 lire les annonces lorsque vous êtes prêt.

L'extrait 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 ImaSdkSettings et AdEvents. Pour cette raison, 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 implémenter le SDK IMA ?

Non. La lecture manuelle des annonces est une fonctionnalité facultative pour les éditeurs qui ne souhaitent pas que le SDK IMA lance automatiquement les coupures publicitaires conformément à une règle relative aux annonces ou à une réponse VMAP.