プレーヤーの例
下のプレーヤーをマウスオーバーまたはオフにして、機能を確認します。
ペンを見る18165-拡大-プレーヤー-マウスオーバー Brightcove Learning Services（ @ bcls1969） オンCodePen。
ソースコード
CodePen を使用する
上記のCodePenを効果的に使用するためのヒントは次のとおりです。
- [ 結果]ボタンをクリックして、プレーヤーの実際の表示を切り替えます。
- HTML/CSS/JSボタンをクリックして、いずれかのコードタイプを表示します。
- このドキュメントの後半では、アプリケーションで使用されるロジック、フロー、およびスタイル設定については、 Player/HTML設定、アプリケーションフロー、およびアプリケーションのスタイル設定で説明されます。セクション。これらのセクションの情報に沿って従う最も良い方法は、次のとおりです。
- CodePen の [ EDIT ON CODEPEN]ボタンをクリックし、1 つのブラウザ/ブラウザタブでコードを使用できるようにします。
- CodePen で、表示するコードを調整します。CodePen 内の異なるコードセクションの幅を変更できます。
- を見るプレーヤー/ HTML構成、アプリケーションフローおよび/またはアプリケーションのスタイリング別のブラウザ/ブラウザタブのセクション。これで、コードの説明に従い、同時にコードを表示できるようになります。
開発シーケンス
推奨される開発順序は次のとおりです。
- インページ埋め込みプレーヤーの実装を使用して、プレーヤー、プラグイン、CSS の機能をテストします (CSS が必要な場合)
- ローカルテストのためにプラグインのJavaScriptとCSSを別々のファイルに置く
- エラーを解決したら、プラグインコードとCSSをサーバーにデプロイします
- Studio を使用してプラグインと CSS をプレイヤーに追加する
- iframe の実装が適切であると判断した場合は、インページ埋め込みプレーヤーの実装を置き換えます (次のセクションで詳しく説明します)。
これらの手順の詳細については、「ステップバイステップ」を参照してください。プラグイン開発ガイド。
iframe またはページ内埋め込み
Brightcove Player の拡張機能を開発する際には、コードが iframe 実装またはページ内埋め込み実装に最も適しているかどうかを判断する必要があります。ベストプラクティスの推奨事項は、iframe 実装で使用するプラグインを構築することです。iframe プレーヤーを使用する利点は次のとおりです。
- 既存のJavaScriptおよび/またはCSSとの衝突はありません
- 自動応答性
- iframe は、ソーシャルメディアアプリ（または動画が他のアプリに「移動」する必要があるとき）での使用を容易にします。
インページ埋め込みプレーヤーの統合はより複雑になりますが、その実装に関するコードを計画する場合もあります。一般化するために、このアプローチは、包含ページがプレイヤーと通信する必要がある場合に最適です。具体的には、いくつかの例を挙げます。
- 含まれているページのコードは、プレイヤーイベントをリッスンして行動する必要があります
- プレーヤーは包含ページのスタイルを使用します
- iframe は、含まれているページからのリダイレクトのように、アプリロジックが失敗します。
最終実装で iframe コードを使用しない場合でも、JavaScript 用のプラグインと CSS 用の別のファイルを使用して、ページ内埋め込みコードを使用できます。これにより、ロジックがカプセル化され、複数のプレーヤーで簡単に使用できます。
実装の詳細
Player API を使用して、ビデオの再生中に縮小動作を削除し、ビデオが一時停止または終了したときに再度復元するロジックがあります。ここで作成したように、このサンプルではAdvanced (ページ内) プレーヤーの埋め込みを使用する必要があります。iframe埋め込みコードを使用してこの機能を作成することもできますが、ロジックは少し異なり、プラグインに変換されるわけではありません。
API/プラグインリソースを使用
| API イベント |
|---|
| プレイする |
| 一時停止 |
| 終わった |
プレーヤー/HTML構成
この例では、Brightcove Player styleのコードではwidth、heightプロパティがに設定されます100%。
その他のHTML
<div>プレーヤーの埋め込みコードの周りにプレーヤーラッパー要素が追加され、プレーヤーのサイズを動的に制御します。
追加することを忘れないでくださいidに属性video-jsプレーヤーの埋め込みコードにタグを付けます。
<video-js id="myPlayerID"
...
アプリケーションフロー
このアプリケーションの背後にある基本的なロジックは次のとおりです。
- 大小のプレーヤーサイズを定義します。
- プレーヤーを大きくまたは小さくするための機能を追加します。
mouseovermouseoutイベントとイベントのリスナーを追加します。- マウスオーバーで、プレーヤーを大きくします。マウスアウトで、プレーヤーを小さくします。ビデオの再生中は、プレーヤーを大きくしてください。ビデオが一時停止またはビデオが終了したら、プレーヤーを小さくします。
DOM 参照を取得する
Brightcove Playerとラッパーへの参照を取得します。大小のプレーヤーのサイズを定義します。
プレーヤーのサイズを変更する
ラベルが付いたコードを見つけます。
// +++ Change the size of the player +++
プレーヤーを大小にする機能を追加します。
マウスアウトイベントを聞く
ラベルが付いたコードを見つけます。
// +++ Listen for the mouseout event +++
mouseoutでイベントを聞いてくださいplayerWrapper。イベントがトリガーされたら、プレーヤーを小さくします。
プレーヤーのサイズをコントロールする
ラベルが付いたコードを見つけます。
// +++ Control the player size +++
ロジックを追加して、次の操作を実行します。
- 最初はプレーヤーを小さくします。
mouseoverオンにすると、プレーヤーを大きくします。playイベント時には、プレーヤーを大きく保ちます。pauseendedイベントやイベントでは、プレーヤーを小さくします。- で
mouseout、プレーヤーを小さくします。
アプリケーションのスタイリング
CSS playerWrapperは最初に設定し、スモールプレーヤーと大規模プレーヤー間のトランジションを定義します。
プラグインコード
通常、JavaScript を Brightcove Player プラグインに変換する場合は、公称の変更が必要です。必要な変更の 1 つは、ready()メソッドの標準使用をプラグインを定義するコードに置き換えることです。
ここでは、プレーヤーで動作するJavaScriptコードへの非常に一般的に使用されるスタートです：
videojs.getPlayer('myPlayerID').ready(function() {
var myPlayer = this;
...
});
最初の行を変更して、標準の構文を使用して Brightcove Player プラグインを起動します。
videojs.registerPlugin('pluginName', function(options) {
var myPlayer = this;
...
});
前述のように、このドキュメントの対応する GitHub レポ: enlarge-player.js には、プラグインの JavaScript コードが表示されます。
プレーヤーでプラグインを使用する
プラグインの CSS ファイルと JavaScript ファイルをインターネットでアクセス可能な場所に保存したら、プレーヤーでプラグインを使用できます。Studio の PLAYERSモジュールでは、プレーヤーを選択し、[ プラグイン ] セクションで CSS ファイルと JavaScript ファイルに URL を追加し、名前を追加することもできます。オプションが必要な場合は、[Options] と [Options]
実装に関する注意事項
-
インスタンスごとにプレーヤーの小さいサイズと大きいサイズを指定できるようにする場合は、それらをオプションとしてプラグインに渡し、プラグインコードを変更してオプションオブジェクトから値を読み取ることができます。ステップバイステップを参照してください。これを行う方法の詳細は、プラグイン開発。
-
インページプレーヤーの代わりにiframeプレーヤーを使用する場合は。プレーヤーラッパーの div は iframe タグを囲み、プレーヤーのサイズを管理する Javascript はここで表示されるものと非常に似ています。しかし、プレーヤープラグインではなく、HTMLページにある必要があります。