Guía: migración de contrib-ads

Resumen

Una de las mejores características de Video.js es la comunidad de complementos y personalizaciones que se ha creado a su alrededor. El soporte publicitario es una parte importante de ese ecosistema, pero no todos los autores de complementos escriben teniendo en cuenta los anuncios. Brightcove está realizando grandes cambios en videojs-contrib-ads para hacer que los anuncios sean más compatibles con el resto del universo Video.js. En la versión 2.0 del complemento, el complemento re-envía eventos con diferentes prefijos dependiendo de si se está reproduciendo un anuncio o no. Cuando se reproduce un anuncio, los eventos tienen el prefijo anuncio y cuando el contenido se reanuda después de una pausa publicitaria, los eventos tienen el prefijo contenido. Por ejemplo, un pause evento durante un anuncio se convertiría en un adpause evento. Esto significa que, desde la perspectiva de un autor de complementos (no publicitarios), Video.js se comportará de la misma manera tanto si se reproducen anuncios como si no. Y si alguien quiere escribir un complemento que tenga en cuenta los anuncios, esos eventos originales todavía están disponibles para que se conecten.

Procedimientos de migración

Si ha escrito su propia integración de anuncios además de videojs-contrib-ads , hay un par de cosas que debe hacer para prepararse para la actualización:

• Aplique el prefijo apropiado a sus controladores de eventos. Si estuvieras escuchando timeupdate eventos durante la reproducción de anuncios, ahora debería estar atento adtimeupdate. Los eventos de video que ocurren durante la reproducción de contenido no se ven afectados.
• Escuchar contentended para activar postrolls en lugar de ended. Cuando se reproduce el contenido, el ended el evento se captura y se vuelve a enviar como contentended para que otros complementos no vean múltiples ended eventos para el mismo video. Una vez finalizado el contenido y los postrolls, contrib-ads disparará un ended evento.
• Aconseje a sus usuarios que incluyan e inicialicen su complemento antes de que inicien otros complementos. El complemento contrib-ads se encargará de volver a enviar los eventos, pero no puede ocultarlos para los complementos registrados anteriormente en la cadena de escucha.
• El soporte extendido para postrolls agregó un nuevo postrollTimeout opción, similar a los prerolls. Si no desea reproducir un postroll de un video, puede disparar adtimeout para pasar al siguiente video inmediatamente.