サポートに連絡する| システムステータス
ページコンテンツ

    Brightcove Playerプラグイン

    このトピックでは、Brightcoveが提供するBrightcoveプレーヤー用のプラグインについて学習します。これらのプラグインは、プレーヤーを強化するために使用されます。

    追加リソース

    次のドキュメントは、プラグインの作成および使用に関するより詳細な洞察を提供します。

    はじめに

    Brightcove Player用のプラグインは、HTML、JavaScript、CSS の組み合わせを使用して、何らかの方法でプレーヤーをカスタマイズします。言い換えれば、Webページでできることは何でも、プラグインで行うことができます。

    広義には、プラグインは次の目的で開発できます。

    • 既定の動作の変更
    • 機能の追加
    • 外観をカスタマイズする（標準のCSSでは実行できません）

    ブライトコーブのプラグイン

    概要:Player Plugins ドキュメントには、ブライトコーブが提供するプラグインと、デフォルトでロードされるプラグインの一覧が表示されます。

    ブライトコーブが提供するプラグインは、さまざまな方法で使用できます。すべてはを使用して実装できますがプラグインスタジオのセクションプレイヤーモジュールには、広告、エンドスクリーン、ソーシャルなどの機能をロードするための専用セクションがあるものもあります。また、いくつかのプラグインのいくつかの追加のヘルプを得ることができますプラグインこれらのスクリーンショットに示されているセクション：

    add plugin in Studio
    brightcove supplied plugin

    スタジオでのプラグインの追加

    そうでない場合、または別の方法でプラグインを追加する方法がない場合は、次の形式を使用します。示されているように、最初に選択しますカスタムプラグイン、フォームが完成したように見えます。

    add plugin in Studio
    add plugin in Studio

    プラグイン名、JavaScriptファイルへのインターネットアクセス可能なリンク、CSSファイル（必要な場合）およびオプションを追加していることがわかります。

    デフォルトのプラグイン

    デフォルトでロードされるプラグインは 2 つあります。彼らは次のとおりです。

    • エラー -プレイヤーは、エラーが発生したときにユーザーフレンドリーなメッセージを表示することができます。表示は、半透明のオーバーレイで、既定のスタイルシートによってスタイル設定されます。
    • HLS -HLS をサポートしていないが Flash Player が搭載されているプラットフォームで HLS ビデオを再生します。は、m3u8 マニフェスト内のビデオコンテンツをプレーヤーで再生できるようにします。

    特定のプラグインをロードしたくない場合は、falseプレーヤーまたは子プレーヤーを作成/更新するときに、特定のデフォルトのプラグインをに設定することで、それを防ぐことができます。hls、debuggererrorsおよびフィールドは下にネストされていることに注意してくださいconfigurationプロパティを使用し、他のグループ化プロパティではなく、 POSTを使用して新しいプレーヤーを作成するとき：

    curl \
  --header "Content-Type: application/json" \
  --user $EMAIL \
  --request POST \
  --data '{
      "name": "MySamplePlayer",
      "configuration": {
        "media": {
          "sources": [{
            "src":"http://solutions.brightcove.com/bcls/assets/videos/Tiger.mp4",
            "type":"video/mp4"
          }]
        },
        "hls": false,
        "errors": false
      }
    }' \
    https://players.api.brightcove.com/v2/accounts/$ACCOUNT_ID/players

    をオフにする場合hls、、debuggererrorsおよび/またはプラグイン（複数可）既存のプレーヤーの場合は、次のようにパッチを使用する必要があります。

    curl \
  --header "Content-Type: application/json" \
  --user $EMAIL \
  --request PATCH \
  --data '{
      "hls": true,
      "errors": true
    }' \
  https://players.api.brightcove.com/v2/accounts/$ACCOUNT_ID/players/$PLAYER_ID/configuration

    デフォルトのプラグインがロードされているかどうかを検出するには？

    デフォルトのプラグインがロードされているかどうかは、プレーヤーの URL または embed_in_page 実装を使用しているときにブラウザーのコンソールに移動し、対応するプラグインオブジェクトが存在するかどうかを確認することで確認できます。次のスクリーンショットは、プラグインの存在を示しています。

    default-plugin-with-hls

    特定のデフォルトプラグインをロードしないように設定した場合、そのオブジェクトはページに表示されません。次のスクリーンショットでは、HLSプラグインオブジェクトが存在しないことがわかります。

    default-plugin-no-hls

    データを渡す

    では、options追加の子プロパティを使用することもできますplugins。これにより、初期化時に使用するデータをプラグインに渡すことができます。また、プラグインの再利用が大幅に強化され、単一のプラグインの異なる使用のために異なる実装データを渡すことができれば、プラグインがより柔軟になります。

    optionプロパティの詳細については、「プラグインにデータを渡す」ドキュメントを参照してください。

    プラグインと PostMessage ()

    iframeプレーヤーの実装では、親ページからiframeにデータを送信したい場合があります。これは、postMessage() JavaScriptのメソッドを使用して可能です。簡単に言えば、親ページでは、postMessage() iframeにメッセージを送信するために使用され、イベントリスナーを使用してメッセージを取得し、それに基づいて行動します。

    詳しい説明と実例については、「iframe 親からビデオを再生」ドキュメントを参照してください。

    スタイルシートの役割

    プラグインとそのプラグインに関連付けられたスタイルシートの両方を持つことは珍しいことではありません。たとえば、ステップバイステップで使用される単純なプラグインでは、Player Management では、プラグイン自体は JavaScript を使用してプレーヤーにテキストを配置しますが、関連するスタイルシートは色、フォントサイズ、位置をコントロールします。これは、次のベストプラクティスに抽象化することができます。

    • スタイルシートが最善を尽くすタスクを実行するには、プラグインにスタイルシートが関連付けられている必要があります。プラグインでスタイリングを行うのは、スタイルシートで行うことができない場合のみです。たとえば、スタイルシートの動的選択などです。

    互換性

    Brightcove Player のベースとなっているオープンソース videojs プレーヤーには、多くのプラグインが構築されています。これらのプラグインは、Videojs プレーヤーのバージョンが Brightcove Player のベースと同じバージョンである場合に限り、Brightcove Playerと互換性があります。Brightcove Player は、バージョンごとにオープンソースの videojs プレーヤーよりも前または後ろにある場合があります。

    ページの最終更新日05 May 2022