このトピックでは、Brightcove の各パブリッシング コード タイプにおいて、パラメータを指定してプレーヤにコンテンツを割り当てる方法について説明します(JavaScript、ActionScript、HTML embed タグ、およびリンク URL)。
動画コンテンツをアップロードし、プレーヤを作成すると、動画コンテンツをプレーヤに割り当てる必要があります。これにより、適切なプレーヤで適切な動画コンテンツが再生されます。一部のプレーヤ テンプレートでは、プレイリストを割り当てることができません。プレイリストをプレーヤに割り当てることができない場合、Media モジュールに「Publish videos to this player using Quick Publish or the Brightcove APIs.」というメッセージが表示されます。
開始する前に、まず Brightcove Studio にコンテンツをアップロードします。Media モジュールの基礎および Media モジュールを使用して動画をアップロードするにある手順に従ってください。また、プレーヤをまだ作成していない場合は、Brightcove Studio ジャンプスタート: Brightcove プレーヤを初めて作成するにある手順に従って、プレーヤを作成してください。
Media モジュールを使用せずにコンテンツをプレーヤに割り当てるには、プレーヤに対するパブリッシング コード内のパラメータで、再生したい動画またはプレイリストを指定します。動画またはプレイリストを指定する際、動画 ID/プレイリスト ID または参照 ID を使用できますが、同じパブリッシング コード内で両方を使用することはできません。動画 ID を調べる方法は次の 2 通りあります。
プレーヤで再生したい動画またはプレイリストの ID が判明した後に、その動画またはプレイリストをプレーヤに割り当てます。コンテンツを割り当て方法は 4 通りあります。どの割り当て方法を使用するかは、プレーヤをどのように公開したか、そしてプレーヤで再生するコンテンツをどのように制御するかによって異なります。割り当てるための構文は、使用したパブリッシング コードの種類によって異なります。
Media モジュールでプレーヤにコンテンツを割り当てる方法も、他にいくつかあります。詳細は、Media モジュールを使用してコンテンツをプレーヤに割り当てるおよびクイック動画公開を参照してください。さらに、プレーヤ パブリッシング コードの構成パラメータを使用して、プレーヤがプレイリストから特定の動画を再生するよう指定できます。詳細は、プレーヤ内の優先コンテンツを指定するを参照してください。
このトピックでは、Brightcove の各パブリッシング コード タイプを使用して、パラメータを指定してプレーヤに単一動画またはプレイリストを割り当てる方法について学びます。
単一動画を受け入れ JavaScript コードを使用して公開したプレーヤに動画 ID を渡すには、JavaScript パブリッシング コードに次のパラメータを追加します。
<param name="@videoPlayer" value="12345" />
12345 は、このプレーヤで再生したい動画の動画 ID です。
プレーヤを公開し、ロード時に再生する 1 本の動画(ID: 12345)を割り当てるための、HTML コードの例を次に示します。
<script language="JavaScript" type="text/javascript" src=" http://admin.brightcove.co.jp/js/BrightcoveExperiences.js"></script> <object id="myPlayer" class="BrightcoveExperience"> <param name="bgcolor" value="#FFFFFF" /> <param name="width" value="486" /> <param name="height" value="412" /> <param name="playerID" value="1234567890" /> <param name="isVid" value="true" /> <param name="@videoPlayer" value="12345" /> </object>
単一動画を受け入れ JavaScript コードを使用して公開したプレーヤに参照 ID を渡すには、JavaScript パブリッシング コードに次のパラメータを追加します。
<param name="@videoPlayer" value="ref:myVid12345" />
myvid12345 は、このプレーヤで再生したい動画の参照 ID です。参照 ID の前に ref: を付加する必要があることに注意してください。
プレーヤを公開し、ロード時に再生する 1 本の動画(ID: 12345)を割り当てるための、HTML コードの例を次に示します。
<script language="JavaScript" type="text/javascript" src=" http://admin.brightcove.co.jp/js/BrightcoveExperiences.js"></script> <object id="myPlayer" class="BrightcoveExperience"> <param name="bgcolor" value="#FFFFFF" /> <param name="width" value="486" /> <param name="height" value="412" /> <param name="playerID" value="1234567890" /> <param name="isVid" value="true" /> <param name="@videoPlayer" value="ref:myVid12345" /> </object>
複数のプレイリストを受け入れ、JavaScript コードを使用して公開したプレーヤにプレイリスト ID を渡すには、次のように、JavaScript パブリッシング コードに playlistTabs または playlistCombo パラメータを追加します。
<param name="@playlistTabs" value="6789"/> <param name="@playlistCombo" value="6789"/>
6789 は、このプレーヤで再生したいプレイリストのプレイリスト ID です。タブ型プレイリストを備えたプレーヤには playlistTabs 構成パラメータを使用します。コンボボックス(ドロップダウン)型プレーヤを備えたプレーヤには playlistTabs 構成パラメータを使用します。プレイリスト ID を複数個渡す場合は、各プレイリスト ID をコンマで区切り記載します。
<param name="@playlistTabs" value="6789,9876,5432"/>
Widescreen with Horizontal List テンプレートなど、List コンポーネントまたは Tablist コンポーネントからコンテンツを取得するプレーヤは、単一のプレイリストのみを受け入れます。単一のプレイリストのみを受け入れ、JavaScript コードを使用して公開したプレーヤにプレイリスト ID を渡すには、JavaScript パブリッシング コードに videoList パラメータを追加します。
<param name="@videoList" value="6789"/>
プレーヤを公開し、ロード時に再生するプレイリスト(プレイリスト ID: 6789)を割り当てるための、HTML コードの例を次に示します。
<script language="JavaScript" type="text/javascript" src="http://admin.brightcove.co.jp/js/BrightcoveExperiences.js"></script> <object id="myPlayer" class="BrightcoveExperience"> <param name="bgcolor" value="#FFFFFF" /> <param name="width" value="790" /> <param name="height" value="529" /> <param name="playerID" value="1234567890" /> <param name="isVid" value="true" /> <param name="isUI" value="true" /> <param name="@playlistTabs" value="6789" /> </object>
複数のプレイリストを受け入れ、JavaScript コードを使用して公開したプレーヤにプレイリストの参照 ID を渡すには、次のように、JavaScript パブリッシング コードに playlistTabs または playlistCombo パラメータを追加します。パラメータ値を指定する際、参照 ID の前に ref: を付加します。
<param name="@playlistTabs" value="ref:myPlaylist6789"/> <param name="@playlistCombo" value="ref:myPlaylist6789"/>
myPlaylist6789 は、このプレーヤで再生したいプレイリストの参照 ID です。プレイリストの参照 ID を複数個渡す場合は、参照 ID 同士をコンマで区切り、先頭の参照 ID の前に ref: を付加します。その際、コンマの前後にスペースを挿入しないでください。
<param name="@playlistTabs" value="ref:myPlaylist6789,yourPlaylist9876,herPlaylist5432"/>
Widescreen with Horizontal List テンプレートなど、List コンポーネントまたは Tablist コンポーネントからコンテンツを取得するプレーヤは、単一のプレイリストのみを受け入れます。単一のプレイリストのみを受け入れ、JavaScript コードを使用して公開したプレーヤにプレイリストの参照 ID を渡すには、JavaScript パブリッシング コードに videoList パラメータを追加します。パラメータ値を指定する際、参照 ID の前に ref: を付加します。
<param name="@videoList" value="ref:myPlaylist6789"/>
プレーヤを公開し、ロード時に再生するプレイリスト(参照 ID: myPlaylist6789)を割り当てるための完全な HTML コードは次のようになります。
<script language="JavaScript" type="text/javascript" src="http://admin.brightcove.co.jp/js/BrightcoveExperiences.js"></script> <object id="myPlayer" class="BrightcoveExperience"> <param name="bgcolor" value="#FFFFFF" /> <param name="width" value="790" /> <param name="height" value="529" /> <param name="playerID" value="1234567890" /> <param name="isVid" value="true" /> <param name="isUI" value="true" /> <param name="@playlistTabs" value="ref:myPlaylist6789" /> </object>
単一動画を受け入れ ActionScript コードを使用して公開されるプレーヤに動画 ID を渡すには、次のように videoPlayer 構成パラメータを使用します。
config["@videoPlayer"] = "12345";
12345 は、このプレーヤで再生したい動画の動画 ID です。Publishing モジュールからコピーしたプレーヤ用に、この構成パラメータを ActionScript パブリッシング コードに追加します。
単一動画を受け入れ ActionScript コードを使用して公開されるプレーヤに動画の参照 ID を渡すには、次のように、videoPlayer 構成パラメータを使用し、参照 ID の前に ref: を付加します。
config["@videoPlayer"] = "ref:myVideo12345";
myVideo12345 は、このプレーヤで再生したい動画の参照 ID です。Publishing モジュールからコピーしたプレーヤ用に、この構成パラメータを ActionScript パブリッシング コードに追加します。
複数のプレイリストを受け入れ ActionScript コードを使用して公開されるプレーヤにプレイリスト ID を渡すには、playlistTabs または playlistCombo 構成パラメータを使用します。
config["@playlistTabs"] = "6789"; config["@playlistCombo"] = "6789";
6789 は、このプレーヤで再生したいプレイリストのプレイリスト ID です。タブ型プレイリストを備えたプレーヤには playlistTabs 構成パラメータを使用します。コンボボックス(ドロップダウン)型プレーヤを備えたプレーヤには playlistTabs 構成パラメータを使用します。構成パラメータを、Publishing モジュールからコピーしたプレーヤ用に ActionScript パブリッシング コードに追加します。プレイリスト ID を複数個渡す場合は、各プレイリスト ID をコンマで区切り記載します。
config["@playlistTabs"] = "6789,9876,5432";
Widescreen with Horizontal List テンプレートなど、List コンポーネントまたは Tablist コンポーネントからコンテンツを取得するプレーヤは、単一のプレイリストのみを受け入れます。単一のプレイリストのみを受け入れ、ActionScript コードを使用して公開したプレーヤにプレイリスト ID を渡すには、次のように、ActionScript パブリッシング コードに videoList パラメータを追加します。
config["@videoList"] = "6789";
複数のプレイリストを受け入れ ActionScript コードを使用して公開されるプレーヤにプレイリストの参照 ID を渡すには、playlistTabs または playlistCombo 構成パラメータを使用し、参照 ID の前に ref: を付加します。
config["@playlistTabs"] = "ref:myPlaylist6789"; config["@playlistCombo"] = "ref:myPlaylist6789";
myPlaylist6789 は、このプレーヤで再生したいプレイリストの参照 ID です。Publishing モジュールからコピーしたプレーヤ用に、この構成パラメータを ActionScript パブリッシング コードに追加します。プレイリストの参照 ID を複数個渡す場合は、参照 ID どうしをコンマで区切り、先頭の参照 ID の前に ref: を付加します。その際、コンマの前後にスペースを挿入しないでください。
config["@playlistTabs"] = "ref:myPlaylist6789,myPlaylist9876,myPlaylist5432";
Widescreen with Horizontal List テンプレートなど、List コンポーネントまたは Tablist コンポーネントからコンテンツを取得するプレーヤは、単一のプレイリストのみを受け入れます。単一のプレイリストのみを受け入れ、ActionScript コードを使用して公開したプレーヤにプレイリストの参照 ID を渡すには、ActionScript パブリッシング コードに videoList パラメータを追加します。プレイリストの参照 ID の前に ref: を付加します。
config["@videoList"] = "ref:myPlaylist6789";
単一動画を受け入れ、HTML を使用して埋め込まれたプレーヤに動画 ID を渡すには、HTML 埋め込みコードの playerID の後に &@videoPlayer=12345 を追加します。ここで、12345 は、再生したい動画 ID です。これは、埋め込みコードの両方の playerID の後に追加する必要があります。
1 本の動画(動画 ID: 12345)を強制的に再生する HTML 埋め込みコードの例を、次に示します。
<object id="flashObj" width="486"
height="412" classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=9,0,47,0">
<param name="movie" value="http://c.brightcove.co.jp/services/viewer/federated_f9/19174954001?isVid=1" />
<param name="bgcolor" value="#FFFFFF" />
<param name="flashVars" value="playerID=12345678900&@videoPlayer=12345&domain=embed&" />
<param name="base" value="http://admin.brightcove.co.jp" />
<param name="seamlesstabbing" value="false" />
<param name="allowFullScreen" value="true" />
<param name="swLiveConnect" value="true" />
<param name="allowScriptAccess" value="always" />
<embed src="http://c.brightcove.co.jp/services/viewer/federated_f9/19174954001?isVid=1"
bgcolor="#FFFFFF" flashVars="playerID=12345678900&@videoPlayer=12345&domain=embed&"
base="http://admin.brightcove.co.jp" name="flashObj" width="486"
height="412" seamlesstabbing="false" type="application/x-shockwave-flash"
allowFullScreen="true" swLiveConnect="true"
allowScriptAccess="always" pluginspage="http://www.macromedia.com/shockwave/download/index.cgi?P1_Prod_Version=ShockwaveFlash">
</embed>
</object>
単一動画を受け入れ、HTML ページに埋め込まれたプレーヤに動画の参照 ID を渡すには、HTML 埋め込みコード内のプレーヤ ID の後ろに動画の参照 ID の指定を追加します
(例: &@videoPlayer=ref:myVideo12345(myVideo12345 は再生したい動画の参照 ID))。これは、埋め込みコードの両方の playerID の後に追加する必要があります。
複数のプレイリストを受け入れ、HTML ページに埋め込まれたプレーヤにプレイリスト ID を渡すには、HTML 埋め込みコード内の playerID の後ろにプレイリスト ID の指定を追加します (例: &@playlistTabs=6789 または &@playlistCombo=6789 (6789 は再生したいプレイリストのプレイリスト ID))。プレイリスト ID を複数個渡す場合は、各プレイリスト ID をコンマで区切り記載します。 &@playlistTabs=6789,9876,5432
プレーヤが単一のプレイリストのみを受け入れる場合には、代わりに @videoList パラメータを使用します。
(例: &@videoList=6789).
これは、埋め込みコードの両方の playerID の後に追加する必要があります。
1 本のプレイリスト(プレイリスト ID: 6789)を強制的に再生する HTML 埋め込みコードの例を、次に示します。
<object id="flashObj" width="486" height="412"
classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=9,0,47,0">
<param name="movie"
value="http://c.brightcove.co.jp/services/viewer/federated_f9/19174954001?isVid=1&isUI=1" />
<param name="bgcolor" value="#FFFFFF" />
<param name="flashVars" value="playerID=12345678900&@playlistTabs=6789&domain=embed&" />
<param name="base" value="http://admin.brightcove.co.jp" />
<param name="seamlesstabbing" value="false" />
<param name="allowFullScreen" value="true" />
<param name="swLiveConnect" value="true" />
<param name="allowScriptAccess" value="always" />
<embed src="http://c.brightcove.co.jp/services/viewer/federated_f9/19174954001?isVid=1&isUI=1"
bgcolor="#FFFFFF" flashVars="playerID=12345678900&@playlistTabs=6789&domain=embed&"
base="http://admin.brightcove.co.jp" name="flashObj"
width="486" height="412" seamlesstabbing="false"
type="application/x-shockwave-flash" allowFullScreen="true"
swLiveConnect="true" allowScriptAccess="always"
pluginspage="http://www.macromedia.com/shockwave/download/index.cgi?P1_Prod_Version=ShockwaveFlash">
</embed>
</object>
複数のプレイリストを受け入れ HTML ページに埋め込まれたプレーヤに、プレイリストの参照 ID を渡すには、次を追加します。
&@playlistTabs=ref:myPlaylist6789 または &@playlistCombo=ref:myPlaylist6789
HTML 埋め込みコード内の playerID の後ろに、このコードを追加します。myPlaylist6789 は、再生したいプレイリストの参照 ID です。プレイリストの参照 ID を複数個渡す場合は、参照 ID どうしをコンマで区切り、先頭の参照 ID の前に ref: を付加します。
&@playlistTabs=ref:myPlaylist6789,myPlaylist9876,myPlaylist5432
その際、コンマの前後にスペースを挿入しないでください。
プレーヤが単一のプレイリストのみを受け入れる場合には、代わりに @videoList parameter パラメータを使用します。(例: &@videoList=ref:myVideo6789)これは、埋め込みコードの両方の playerID の後に追加する必要があります。
Brightcove によってホスティングされているプレーヤの URL の末尾に、動画 ID の指定を付加することができます (例: ?bctid=12345 (12345 は再生したい動画の動画 ID))。次に例を示します。
http://link.brightcove.co.jp/services/player/bcpid0789?bctid=12345
ユーザー サイトで JavaScript コードを使用してプレーヤをホスティングしている場合、プレーヤの URL を修正することにより、特定の動画を強制的に再生することができます。具体的には、プレーヤの URL の末尾に、動画 ID の指定を付加します(例: ?bctid=12345(12345 は再生したい動画の動画 ID))。次に例を示します。
http://www.myexamplesite.com/playerpage.html?bctid=12345
Brightcove によってホスティングされているプレーヤの URL の末尾に、プレイリスト ID の指定を付加することができます(例: ?bclid=6789(6789 は再生したいプレイリストのプレイリスト ID))。次に例を示します。
http://link.brightcove.co.jp/services/player/bcpid0789?bclid=6789
この方法では、1 つのプレーヤに複数のプレイリストを割り当てることはできません。
ユーザー サイトで JavaScript コードを使用してプレーヤをホスティングしている場合、プレーヤの URL を修正することにより、特定のプレイリストを強制的に再生することができます。具体的には、プレーヤの URL の末尾に、プレイリスト ID の指定を付加します(例: ?bclid=6789(6789 は再生したいプレイリストのプレイリスト ID))。次に例を示します。
http://www.myexamplesite.com/playerpage.html?bclid=6789
コンテンツのプレーヤへの割り当てに関する詳細は、プレーヤをプログラミングセクションを参照してください。