ガイド:contrib-ads の移行
概要
Video.js の最良の機能の 1 つは、プラグインとその周りに構築されたカスタマイズのコミュニティです。広告サポートはそのエコシステムの重要な部分ですが、すべてのプラグイン作成者が広告を念頭に置いて書くわけではありません。ブライトコーブは、Video.js Universe の他の部分と広告との互換性を増すため、videojs-contrib-ads にいくつかの大きな変更を加えています。プラグインのバージョン 2.0 では、プラグインは、広告が再生されているかどうかに応じて、異なるプレフィックスでイベントを再送します。広告を再生すると、イベントの先頭に広告が付き、広告中断後にコンテンツが再開されると、イベントの先頭にコンテンツが表示されます。たとえば、pause
adpause
広告中のイベントはイベントになります。つまり、(広告以外の) プラグイン作成者から見ると、Video.js は広告が再生されているかどうかにかかわらず、まったく同じように動作します。そして、誰かが広告を認識しているプラグインを書きたい場合、それらの元のイベントはまだ彼らがフックするために利用可能です。
移行手順
videojs-contrib-ads の上に独自の広告統合を書いた場合、アップグレードに備えるためにいくつかのことを行う必要があります。
- イベントハンドラに適切なプレフィックスを適用します。
timeupdate
広告の再生中にイベントを聞いていた場合は、ここでリスニングしているはずですadtimeupdate
。コンテンツの再生中に発生するビデオイベントには影響しません。 - の代わりに、
contentended
ポストロールをトリガーするのを聞いてくださいended
。コンテンツを再生すると、ended
イベントがキャプチャされ、再送され、他のプラグインが複数のcontentended
ended
同じビデオのためのイベント。コンテンツとポストロールが終了すると、contrib-adsended
はイベントを発生させます。 - 他のプラグインを起動する前に、プラグインを含めて、初期化するようにユーザーに伝えます。contrib-ads プラグインは、イベントの再ディスパッチを処理しますが、リスナーチェーンで以前に登録されたプラグインでは非表示にできません。
- ポストロールの拡張サポートでは、プレロールと同様に、
postrollTimeout
新しいオプションが追加されました。ビデオのポストロールを再生したくない場合は、adtimeout
すぐに次のビデオに進むために起動することができます。