プレーヤーの埋め込みコードを生成する

このトピックでは、プレビュー用および公開済みプレーヤーの埋め込みコードを生成する方法について説明します。

Players モジュールでは、プレビュー用および公開済みプレーヤーのプレーヤー埋め込みコードとプレーヤー URL を生成できます。通常、実行時にプレーヤーに動画を動的に割り当てたい場合に、Players モジュールを使用してプレーヤーの埋め込みコードを生成します。プレーヤーに動画を動的に割り当てる方法については、プレーヤーへの動画の動的な割り当てを参照してください。

Video Cloud のお客様で、プレイリストまたは単一の動画をプレーヤーに公開したい場合は、Media モジュール内の公開機能を使用してください。詳細については、Media モジュールを使用した動画とプレイリストの公開を参照してください。

プレビュー プレーヤーと公開プレーヤーの違い

プレビュー プレーヤーは、変更内容を公開する前にプレビューするために使用されます。変更内容に問題がなければ、プレーヤーを公開でき、変更内容はすべての公開済みプレーヤーに反映されます。プレビュー プレーヤーには Brightcove のロゴ オーバーレイが表示され、本番環境での使用に適していないことを示します。

公開プレーヤーは最適化されており、Web ページに表示されるプレーヤーです。このプレーヤーには、プレーヤー設定で加えたすべての変更が含まれ、Publish changes ボタンをクリックして公開されます。

Players モジュールを開き、プレーヤーを選択します。プレーヤーの詳細ページで Embed & Preview をクリックするか、リスト ページの行の三点メニューから Embed & Preview を選択します。Embed Player ダイアログで、Preview Player または Published Player をクリックします。

Embed Player dialog

埋め込みコードの種類

生成できる埋め込みコードには 2 種類あります。

  • iframe - ほとんどのケースで推奨されます。プレーヤーを <iframe> タグ内に配置します。プレーヤーのサイズが指定されている場合、iframe はプレーヤーのサイズに合わせて調整されます。プレーヤーのサイズが指定されていない場合、iframe を <div> タグ内に配置でき、プレーヤーのレスポンシブ性により、プレーヤーは <div> 全体のスペースを占めるようサイズ調整されます。
  • JavaScript - プレーヤーを iframe 内ではなく、HTML ページ内に直接配置できます。これにより、開発者はプレーヤーや関連するプロパティおよびイベントに簡単にアクセスできるという利点が得られます。JavaScript 埋め込みコードを使用すると、ソーシャル メディア アプリケーションや共有において、プレーヤーを単一の自己完結型ユニットとして扱うときの使いやすさが失われます。このオプションは公開済みプレーヤーでのみ利用できます。
Embed Player dialog

プレビュー プレーヤーの埋め込みコードの生成

プレビュー プレーヤーの埋め込みコードを生成するには:

  1. Players モジュールを開きます。
  2. コードを生成したいプレーヤーの行をクリックします。プレーヤー名をクリックしてプロパティ ページを開かないでください。
  3. プレーヤーの詳細ページで Embed & Preview をクリックするか、リスト ページの行の三点メニューから Embed & Preview を選択します。
  4. Embed Player ダイアログで Preview Player をクリックし、適切な埋め込みコード タブ（iframe または JavaScript）を選択します。

公開プレーヤーの埋め込みコードの生成

公開プレーヤーの埋め込みコードを生成するには:

  1. Players モジュールを開きます。
  2. コードを生成したいプレーヤーの行をクリックします。
  3. プレーヤーの詳細ページで Embed & Preview をクリックするか、リスト ページの行の三点メニューから Embed & Preview を選択します。
  4. Embed Player ダイアログで Published Player をクリックし、適切な埋め込みコード タブ（iframe または JavaScript）を選択します。

公開プレーヤーの埋め込みコードは、プレーヤー名をクリックして Embed & Preview をクリックすることでもコピーできます。保留中の変更を適用するには、Publish changes ボタンをクリックします。

埋め込みコードへのアプリケーション ID の追加

これまで、パブリッシャーは異なる名前の新しいプレーヤーを作成して、サイトの異なる部分や異なるサイトで使用するのが一般的でした。プレーヤー アナリティクスを確認する際、プレーヤー名が異なれば、どのプレーヤーの再生数が最も多いかを判断しやすくなります。埋め込みコードにアプリケーション ID パラメーターを追加することで、同じプレーヤーをサイト全体または複数サイトにわたって使用でき、アプリケーション ID を使用してプレーヤーが公開された場所を識別できます。プレーヤー アプリケーション ID を使用することで、作成および保守が必要なプレーヤーの数を減らすことができます。埋め込みコードへのアプリケーション ID の追加方法については、プレーヤー埋め込みコードへのアプリケーション ID の追加を参照してください。