プレーヤープラグインの設定

このトピックでは、プレーヤープラグインの設定方法の概要を説明します。

Overview タブの Plugins セクションを使用すると、Brightcove Player にプレーヤープラグイン、スタイルシート、またはスクリプトを追加できます。Plugins セクションには Plugins、Stylesheets、Scripts の 3 つのタブがあります。Plugins タブには、プレーヤーに対して設定されたすべてのプラグインが一覧表示されます。Brightcove 提供のプラグイン（Social、Audience など）は表示されません。

Plugins section

プレーヤープラグインの設定

プラグインは通常、次の目的で開発されます。

  • プレーヤーのデフォルトの動作を変更する
  • プレーヤーに機能を追加する
  • プレーヤーの外観をカスタマイズする

独自のカスタム プラグインを作成する方法については、Step-by-Step: Plugin Developmentを参照してください。

プレーヤーにプラグインを設定するには、次の手順に従ってください。

  1. Players モジュールを開きます。
  2. 設定したいプレーヤーのリンクをクリックします。
  3. Overview タブの Plugins セクションを展開します。
  4. Plugins タブを選択します。
  5. Add Plugin をクリックし、プラグインの種類をクリックします。
    • Custom Plugin - お客様または第三者によって開発されたプラグイン
    • Brightcove Plugin - Brightcove によって開発・提供されたプラグイン
    Add Plugin dropdown
  6. Brightcove Plugins の場合は、リストから Brightcove Plugin を選択します。利用可能なすべての Brightcove プラグインがリストに表示されるわけではないことに注意してください。Brightcove 提供のすべてのプラグインの一覧については、Brightcove Player Pluginsのトピックを参照してください。
    Brightcove Plugin selector
  7. Custom Plugins の場合は、次の項目を入力します。
    • Plugin Name - プラグインの JavaScript ファイル内で定義された名前。
    • JavaScript URL - プラグイン コードを含むファイルへの URL を指定するか、既存のファイルをアップロードします。
    • CSS URL - プラグインで使用される CSS コードを含むファイルへの URL を指定するか、既存のファイルをアップロードします。必ず有効な CSS を指定してください。無効な CSS を指定すると、プレビュー ウィンドウにエラーが表示されます。
    Custom Plugin configuration
  8. Options (JSON) フィールドを使用すると、両方のプラグインの種類に対して JSON 形式のオプションを貼り付けることができます。Brightcove プラグインの場合、利用可能なオプションはプラグインのドキュメントに記載されています。カスタム プラグインの場合、オプションの使用方法はプラグインの JavaScript コードに示されています。
  9. Save をクリックして変更を保存します。

プラグインのプロパティを編集するには、プラグイン名をクリックします。プラグインを削除するには、削除アイコン（）をクリックします。

スタイルシートの追加

CSS ファイルをアップロードしてプレーヤーの外観をカスタマイズできます。

プレーヤーに CSS ファイルを追加するには、次の手順に従ってください。

  1. Players モジュールを開きます。
  2. 設定したいプレーヤーのリンクをクリックします。
  3. Overview タブの Plugins セクションを展開します。
  4. Stylesheets タブを選択します。
  5. Add Stylesheet をクリックします。
    Stylesheets tab
  6. CSS ファイルへの URL を指定するか、既存のファイルをアップロードします。
  7. Save をクリックして変更を保存します。

ファイル パスを編集するには、ファイル名をクリックします。ファイルを削除するには、削除アイコンをクリックします。

スクリプトの追加

スクリプト ファイルをアップロードしてプレーヤーの外観をカスタマイズできます。

プレーヤーにスクリプト ファイルを追加するには、次の手順に従ってください。

  1. Players モジュールを開きます。
  2. 設定したいプレーヤーのリンクをクリックします。
  3. Overview タブの Plugins セクションを展開します。
  4. Scripts タブを選択します。
  5. Add Script をクリックします。
    Scripts tab
  6. JavaScript ファイルへの URL を指定するか、既存のファイルをアップロードします。
  7. Save をクリックして変更を保存します。

ファイル パスを編集するには、ファイル名をクリックします。ファイルを削除するには、削除アイコンをクリックします。

プラグインコードの場所

プラグイン（Brightcove 提供のプラグインまたは自作のカスタム プラグイン）が、上記のように、または Player Management API を使用してプレーヤーに追加されると、プラグインはプレーヤー コード自体の一部になります。プラグイン コードはインターネット上の保存場所から取得され、プラグインが追加された特定のプレーヤー用のコードの一部になります。さらに説明すると、Advanced（in-page）プレーヤー実装を使用する場合、次のような <script> タグが表示されます。

	<script src="//players.brightcove.net/1507807800001/default_default/index.min.js"></script>

これは Brightcove Player を定義するコードです。このファイルには、プレーヤーに追加したプラグインのコードが含まれています。プラグイン コードは Standard（iframe）プレーヤー実装にも含まれます。

独自のプラグインを開発し、インターネット上の保存場所のソース コードを変更した場合は、必ずプレーヤーを再公開してください。再公開しない限り、新しいプラグイン コードは JavaScript ファイルに反映されません。

プラグインの作成方法については、Step-by-Step: Plugin Developmentの開発者向けドキュメントを参照してください。