Anleitung: contrib-ads-Migration
Überblick
Eine der besten Funktionen von Video.js ist die Community von Plugins und Anpassungen, die sich darauf aufgebaut hat. Die Anzeigenunterstützung ist ein wichtiger Bestandteil dieses Ökosystems, aber nicht alle Plugin-Autoren schreiben mit Blick auf Werbung. Brightcove nimmt einige große Änderungen vor Videojs-Contrib-Anzeigen um Werbung mit dem Rest des Video.js-Universums kompatibler zu machen. In Version 2.0 des Plugins sendet das Plugin Ereignisse mit unterschiedlichen Präfixen erneut aus, je nachdem, ob eine Anzeige abgespielt wird oder nicht. Wenn eine Anzeige abgespielt wird, wird Ereignissen ein Präfix vorangestellt Anzeige Wenn der Inhalt nach einer Werbeunterbrechung wieder aufgenommen wird, wird den Ereignissen ein Präfix vorangestellt Inhalt. Zum Beispiel a pause
Ereignis während einer Anzeige würde ein adpause
Veranstaltung. Dies bedeutet, dass sich Video.js aus der Sicht eines (nicht werblichen) Plugin-Autors genauso verhält, unabhängig davon, ob Anzeigen geschaltet werden oder nicht. Und wenn jemand ein Plugin schreiben möchte, das werbefinanziert ist, stehen ihm diese ursprünglichen Ereignisse weiterhin zur Verfügung.
Migrationsverfahren
Wenn Sie zusätzlich Ihre eigene Anzeigenintegration geschrieben haben Videojs-Contrib-Anzeigen Es gibt einige Dinge, die Sie tun sollten, um sich auf das Upgrade vorzubereiten:
- Wenden Sie das entsprechende Präfix auf Ihre Ereignishandler an. Wenn Sie zugehört haben
timeupdate
Ereignisse während der Anzeigenwiedergabe sollten Sie jetzt abhörenadtimeupdate
. Videoereignisse, die während der Wiedergabe von Inhalten auftreten, sind nicht betroffen. - Hören Sie zu
contentended
Postrolls auslösen stattended
. Wenn der Inhalt abgespielt wird, wird dieended
Ereignis wird erfasst und erneut versendet alscontentended
damit andere Plugins nicht mehrere sehenended
Ereignisse für das gleiche Video. Nachdem der Inhalt und die Postrolls abgeschlossen sind, werden Contrib-Anzeigen geschaltetended
Veranstaltung. - Empfehlen Sie Ihren Benutzern, Ihr Plugin einzuschließen und zu initialisieren, bevor sie andere Plugins starten. Das Contrib-Ads-Plugin kümmert sich um das erneute Versenden von Ereignissen, kann sie jedoch nicht für Plugins ausblenden, die zuvor in der Listener-Kette registriert wurden.
- Die erweiterte Unterstützung für Postrolls hat eine neue hinzugefügt
postrollTimeout
Option, ähnlich wie bei Prerolls. Wenn Sie keine Nachrolle für ein Video abspielen möchten, können Sie feuernadtimeout
um sofort mit dem nächsten Video fortzufahren.