Guide : Migration contrib-ads

Aperçu

L'une des meilleures fonctionnalités de Video.js est la communauté de plugins et personnalisations qui s'est construit autour d'elle. Le support publicitaire est une partie importante de cet écosystème, mais tous les auteurs de plug-ins n'écrivent pas avec des publicités à l'esprit. Brightcove apporte de grands changements videojs-contrib-ads pour rendre les publicités plus compatibles avec le reste de l'univers Video.js. Dans la version 2.0 du plugin, le plugin redistribue des événements avec des préfixes différents selon qu'une annonce est en cours de lecture ou non. Lors de la lecture d'une annonce, les événements sont précédés du préfixe un d et lorsque le contenu reprend après une coupure publicitaire, les événements sont précédés du préfixe contenu. Par exemple, un pause événement pendant une annonce deviendrait un adpause un événement. Cela signifie du point de vue d'un auteur de plugin (non publicitaire), Video.js se comportera exactement de la même manière que les annonces soient diffusées ou non. Et si quelqu'un veut écrire un plugin qui est sensible aux annonces, ces événements originaux sont toujours disponibles pour qu'ils puissent se connecter.

Procédures de migration

Si vous avez écrit votre propre intégration publicitaire en plus de videojs-contrib-ads , vous devez effectuer quelques actions pour préparer la mise à niveau:

• Appliquez le préfixe approprié à vos gestionnaires d'événements. Si vous écoutiez timeupdate événements pendant la lecture de l'annonce, vous devriez maintenant être à l'écoute adtimeupdate. Les événements vidéo qui se produisent pendant la lecture du contenu ne sont pas affectés.
• Écouter contentended pour déclencher des postrolls au lieu de ended. Lorsque le contenu est en cours de lecture, le ended l'événement est capturé et redistribué en tant que contentended afin que les autres plugins ne voient pas plusieurs ended événements pour la même vidéo. Une fois le contenu et les posttrolls terminés, les contrib-ads déclencheront un ended un événement.
• Conseillez à vos utilisateurs d'inclure et d'initialiser votre plugin avant qu'ils ne déclenchent d'autres plugins. Le plugin contrib-ads s'occupera de réexpédier les événements, mais il ne peut pas les cacher pour les plugins qui sont enregistrés plus tôt dans la chaîne d'écoute.
• La prise en charge étendue des postrolls a ajouté un nouveau postrollTimeout option, similaire aux prerolls. Si vous ne souhaitez pas lire un postroll pour une vidéo, vous pouvez adtimeout pour passer immédiatement à la vidéo suivante.