ガイド:contrib-ads移行
概要
Video.jsの最も優れた機能の1つは、プラグインとカスタマイズのコミュニティです。 広告のサポートはエコシステムの重要な部分ですが、すべてのプラグインの作者が広告を念頭に置いているわけではありません。 Brightcove いくつか大きな変更を加えています videojs-contrib-ads 広告を他のVideo.js環境とより互換性を持たせることができます。 プラグインのバージョン2.0では、プラグインは、広告が再生されているかどうかに応じて、異なるプレフィックスのイベントを再ディスパッチします。 広告が再生されると、イベントのプレフィックスは ad 広告ブレーク後にコンテンツが再開されると、イベントにはプレフィックスが付きます コンテンツ。 例えば、 pause
広告中のイベントは adpause
イベント。 これは、(非広告)プラグインの作者の観点から見ると、Video.jsは、広告の再生の有無にかかわらず同じように動作します。 また、誰かが広告を意識したプラグインを作成したい場合、それらの元のイベントは引き続き利用できます。
移行手順
独自の広告統合を作成した videojs-contrib-adsアップグレードを準備するために行うべきことがいくつかあります:
- 適切なプレフィックスをイベントハンドラに適用します。 イベントをリッスンしていた場合
timeupdate
広告の再生中に発生したイベントはadtimeupdate
。 コンテンツの再生中に発生するビデオイベントは影響を受けません。 - リッスンします
contentended
ポストロールをトリガーするにはended
。 コンテンツが再生されているとき、ended
イベントがキャプチャされ、再ディスパッチされるcontentended
他のプラグインには複数のended
同じビデオのイベント。 コンテンツとポストロールが終了すると、contrib-adsはended
イベント。 - 他のプラグインを起動する前に、プラグインをインクルードして初期化するようにユーザーに指示します。 contrib-adsプラグインは、再ディスパッチイベントを処理しますが、リスナーチェーンの前に登録されたプラグインに対しては非表示にすることはできません。
- ポストロールの拡張サポートにより、
postrollTimeout
オプション。プリロールと似ています。 動画のポストロールを再生したくない場合は、再生することができますadtimeout
すぐに次のビデオに進みます。