ガイド:contrib-ads の移行

概要

Video.js の最良の機能の 1 つは、プラグインとその周りに構築されたカスタマイズのコミュニティです。広告サポートはそのエコシステムの重要な部分ですが、すべてのプラグイン作成者が広告を念頭に置いて書くわけではありません。ブライトコーブは、Video.js Universe の他の部分と広告との互換性を増すため、videojs-contrib-ads にいくつかの大きな変更を加えています。プラグインのバージョン 2.0 では、プラグインは、広告が再生されているかどうかに応じて、異なるプレフィックスでイベントを再送します。広告を再生すると、イベントの先頭に広告が付き、広告中断後にコンテンツが再開されると、イベントの先頭にコンテンツが表示されます。たとえば、pauseadpause広告中のイベントはイベントになります。つまり、(広告以外の) プラグイン作成者から見ると、Video.js は広告が再生されているかどうかにかかわらず、まったく同じように動作します。そして、誰かが広告を認識しているプラグインを書きたい場合、それらの元のイベントはまだ彼らがフックするために利用可能です。

移行手順

videojs-contrib-ads の上に独自の広告統合を書いた場合、アップグレードに備えるためにいくつかのことを行う必要があります。

• イベントハンドラに適切なプレフィックスを適用します。timeupdate広告の再生中にイベントを聞いていた場合は、ここでリスニングしているはずですadtimeupdate。コンテンツの再生中に発生するビデオイベントには影響しません。
• の代わりに、contentendedポストロールをトリガーするのを聞いてくださいended。コンテンツを再生すると、endedイベントがキャプチャされ、再送され、他のプラグインが複数のcontentendedended同じビデオのためのイベント。コンテンツとポストロールが終了すると、contrib-ads endedはイベントを発生させます。
• 他のプラグインを起動する前に、プラグインを含めて、初期化するようにユーザーに伝えます。contrib-ads プラグインは、イベントの再ディスパッチを処理しますが、リスナーチェーンで以前に登録されたプラグインでは非表示にできません。
• ポストロールの拡張サポートでは、プレロールと同様に、postrollTimeout新しいオプションが追加されました。ビデオのポストロールを再生したくない場合は、adtimeoutすぐに次のビデオに進むために起動することができます。