パッケージ化されたプラグイン

このトピックでは、Brightcove Player バージョン 7.21.0 で導入されたパッケージ化されたプラグインについて説明します。これにより、コアプレーヤー機能を管理する新しい方法が提供されます。この方法は、従来のプラグイン レジストリを置き換えるものになります。

パッケージ化されたプラグインとは何ですか?

広告、サムネイルシーク、プレイリストなどのプレーヤー機能は、これまでプラグインとして提供されており、それらの管理はプラグイン レジストリと呼ばれる別のサービスによって処理されていました。プラグイン レジストリは、ユーザーの手を煩わせることなくプラグインを効率的に管理できるように設計されましたが、年を追うごとに混乱やバージョンの不一致を招き、回避できたはずの問題を引き起こしていました。

よくある問題としては、新しいプレーヤーバージョンで古いプラグインバージョンを使用しようとする場合(またはその逆の場合)があります。この場合、プラグインが特定のプレーヤー機能に依存しており、それが予想と異なる、あるいは存在しない場合、不具合やエラーが発生します。特に、ブラウザがデフォルトで音声付き自動再生をブロックするようになったことで、広告でこのような例が複数見られました。

機能をプレーヤーのコアに統合することで、使用されるコードがプレーヤーに適したバージョンであることを保証します。別のバージョンが存在しないため、期待通りに機能するようにテストされたプレーヤーの一部となります。

現在サポートされているパッケージ化されたプラグイン

Brightcove プラグイン レジストリ ID(v7.21.0 未満のプレーヤー) パッケージ プラグイン名(v7.21.0+)
サムネイル シーク @brightcove/videojs-thumbnails thumbnails
IMA3 @brightcove/videojs-ima3 ima3
SSAI @brightcove/videojs-ssai ssai
カスタム エンド スクリーン @brightcove/videojs-custom-endscreen customEndscreen
ソーシャル共有 @brightcove/videojs-social social
画質選択 @brightcove/videojs-quality-menu qualityMenu
プレイリスト UI @brightcove/videojs-bc-playlist-ui bcPlaylistUi

プラグインのバージョンXをプレーヤーのバージョンYで使用する必要がある場合はどうすればよいですか?

その必要はありません! パッケージ化されたプラグインの概念は、使用する機能がプレーヤーのバージョンと100%互換性があることを保証することにあります。異なるバージョンを使用しようとするのは、この原則に反しています。

パッケージ化されたプラグインを使用しているかどうかを知るにはどうすればよいですか?

レジストリ プラグイン - このJSONには injected_versionsscripts または stylesheets が含まれていないことに注目してください。レジストリがこれを実現しています:

          
            "plugins": [{
              "registry_id": "@brightcove/videojs-custom-endscreen",
              "version": "3.x",
              "options": {
                "content": ""
              }
            }],
          
        

同じ機能のパッケージ化されたプラグイン バージョン:

          
            "plugins": [{
              "name": "customEndscreen",
              "is_packaged": true,
              "options": {
                "content": ""
              }
            }],
          
        

パッケージ化されたプラグインは、registry_idname に、versionis_packaged: true に置き換えています。

プレーヤー情報モーダルでは、プラグイン バージョンが「Packaged with Player」として表示されます。バージョン文字列が表示される場合、それは古いレガシーバージョンであり、現在のパッケージ化されたプラグイン バージョンに更新することができます。

プレーヤーの読み込み時にコア プラグインを「サイドロード」しなければならない場合はどうすればいいですか?

その必要はなく、また、推奨しません。Brightcoveのプレーヤー管理システムは、必要なすべての機能をまとめ、これらの機能を備えた動作可能なプレーヤーをユーザーに提供するように設計されています。

具体例を挙げると:

  • 広告を提供する必要がある場合、IMA3 プラグインをサイドロードするのではなく、IMA3機能が有効になっているプレーヤーを使用してください。
  • その他の状況で広告が不要な場合は、IMA3 機能が有効になっていない別のプレーヤーを使用してください。
  • 両方のシナリオに対応するには、IMA3 が有効になっているプレーヤーを使用し、必要に応じてプログラムで広告を設定してください。

カスタム プラグインやサードパーティ製プラグインについてはどうですか?

それらの機能に変更や削除はありません。これらの変更は、プラグイン レジストリによって管理されているプラグインにのみ影響します。