正しいコード タイプの選択

このトピックでは、Brightcove Player を使用して動画を公開する際に利用できる埋め込みコードの種類について概要を説明します。

Media モジュールを使用して動画を公開する際、プレーヤー URL を使って動画をプレビューしたり、iframe または Videoタグ埋め込みコードをコピーして Web ページやアプリケーションに貼り付けることができます。

iframe リンクには iframe 埋め込みコードが表示され、Videoタグ リンクには Videoタグ埋め込みコードが表示されます。Player Management API の観点では、Videoタグ プレーヤーコードは embed_in_page 実装としても参照されます。

iframe 埋め込みコード(Standard)

一般的な iframe 埋め込みコードは次のようになります:

 <iframe src="https://players.brightcove.net/1507807800001/rf1BTdKk6M_default/index.html?videoId=6116779877001"
   allowfullscreen=""
   allow="encrypted-media"
   width="960" height="540"></iframe>

iframe 埋め込みコードを使用する利点としては、以下が挙げられます:

  • 既存の JavaScript や CSS と衝突しない
  • 自動的にレスポンシブ対応
  • ソーシャルメディア アプリや外部環境での利用に適している (例:Facebook では、ページに <video> タグや関連 JavaScript を直接置くより iframe の方が安全性が高いと認識されるため許可される)

Videoタグ埋め込みコード(Advanced)

一般的な Videoタグ埋め込みコードは次のようになります:

 <video-js data-account="1507807800001"
   data-player="rf1BTdKk6M"
   data-embed="default"
   controls=""
   data-video-id="6116779877001"
   data-playlist-id=""
   data-application-id=""
   width="960" height="540"></video-js>
 <script src="https://players.brightcove.net/1507807800001/rf1BTdKk6M_default/index.min.js"></script>

Videoタグ埋め込みコードの統合はやや複雑ですが、ページ側でプレーヤーと連携する必要がある場合に最適です。以下は Videoタグ埋め込みコードを使用すべき例です:

  • 含まれるページのコードがプレーヤーイベントを監視・制御する必要がある場合
  • プレーヤーが親ページのスタイルを利用する必要がある場合
  • iframe コードではアプリケーション ロジックが正しく動作しない場合(例:親ページからのリダイレクトが必要な場合)

最終的に iframe 埋め込みコードを使用しない場合でも、JavaScript プラグインや CSS ファイルを分離することで Videoタグコードを利用し、複数プレーヤーでロジックを再利用できます。

推奨事項

特別なアプリケーション ロジックが必要でない限り、iframe実装を使用することがベストプラクティスとされています。 ただし、多くの場合アプリケーション ロジックが必要となるため、Videoタグ(in-page)コードが最適な選択となるケースも多くあります。

Campaign モジュールを使用して視聴者エンゲージメントを追跡する場合、Videoタグ(in-page)埋め込みコードを使用する必要があります。