パラメータを指定してコンテンツをプレーヤに割り当てる

Product
Video Cloud
対象となる役割
パブリッシャ
バージョン
Brightcove 5
エディション
すべて

このトピックでは、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 通りあります。

  • Media モジュールのメディア ライブラリでその動画を探してデータグリッドに表示し、[ID] 列の値を使用する。
  • Brightcove Media API を使用して動画 ID を調べる。たとえば、find_videos_by_text メソッドを使用して、特定の名前の動画の ID を取得することができます。

プレーヤで再生したい動画またはプレイリストの ID が判明した後に、その動画またはプレイリストをプレーヤに割り当てます。コンテンツを割り当て方法は 4 通りあります。どの割り当て方法を使用するかは、プレーヤをどのように公開したか、そしてプレーヤで再生するコンテンツをどのように制御するかによって異なります。割り当てるための構文は、使用したパブリッシング コードの種類によって異なります。

Media モジュールでプレーヤにコンテンツを割り当てる方法も、他にいくつかあります。詳細は、Media モジュールを使用してコンテンツをプレーヤに割り当てるおよびクイック動画公開を参照してください。さらに、プレーヤ パブリッシング コードの構成パラメータを使用して、プレーヤがプレイリストから特定の動画を再生するよう指定できます。詳細は、プレーヤ内の優先コンテンツを指定するを参照してください。

このトピックでは、Brightcove の各パブリッシング コード タイプを使用して、パラメータを指定してプレーヤに単一動画またはプレイリストを割り当てる方法について学びます。

JavaScript

JavaScript:動画 ID を使用して 1 本の動画を割り当てる

単一動画を受け入れ JavaScript コードを使用して公開したプレーヤに動画 ID を渡すには、JavaScript パブリッシング コードに次のパラメータを追加します。

<param name="@videoPlayer" value="12345" />

12345 は、このプレーヤで再生したい動画の動画 ID です。

例:JavaScript:動画 ID を使用して 1 本の動画を割り当てる

プレーヤを公開し、ロード時に再生する 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 を使用して 1 本の動画を割り当てる

単一動画を受け入れ JavaScript コードを使用して公開したプレーヤに参照 ID を渡すには、JavaScript パブリッシング コードに次のパラメータを追加します。

<param name="@videoPlayer"  value="ref:myVid12345" />

myvid12345 は、このプレーヤで再生したい動画の参照 ID です。参照 ID の前に ref: を付加する必要があることに注意してください。

例:JavaScript:参照 ID を使用して 1 本の動画を割り当てる

プレーヤを公開し、ロード時に再生する 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 コードを使用して公開したプレーヤにプレイリスト 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"/>

例:JavaScript:プレイリスト ID を使用してプレイリストを割り当てる

プレーヤを公開し、ロード時に再生するプレイリスト(プレイリスト 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 コードを使用して公開したプレーヤにプレイリストの参照 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"/>

例:JavaScript:参照 ID を使用してプレイリストを割り当てる

プレーヤを公開し、ロード時に再生するプレイリスト(参照 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

ActionScript:動画 ID を使用して 1 本の動画を割り当てる

単一動画を受け入れ ActionScript コードを使用して公開されるプレーヤに動画 ID を渡すには、次のように videoPlayer 構成パラメータを使用します。

config["@videoPlayer"] = "12345";

12345 は、このプレーヤで再生したい動画の動画 ID です。Publishing モジュールからコピーしたプレーヤ用に、この構成パラメータを ActionScript パブリッシング コードに追加します。

ActionScript:参照 ID を使用して 1 本の動画を割り当てる

単一動画を受け入れ ActionScript コードを使用して公開されるプレーヤに動画の参照 ID を渡すには、次のように、videoPlayer 構成パラメータを使用し、参照 ID の前に ref: を付加します。

config["@videoPlayer"] = "ref:myVideo12345";

myVideo12345 は、このプレーヤで再生したい動画の参照 ID です。Publishing モジュールからコピーしたプレーヤ用に、この構成パラメータを ActionScript パブリッシング コードに追加します。

ActionScript:プレイリスト ID を使用してプレイリストを割り当てる

複数のプレイリストを受け入れ 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 を使用してプレイリストを割り当てる

複数のプレイリストを受け入れ 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 埋め込み

HTML 埋め込み:動画 ID を使用して 1 本の動画を割り当てる

単一動画を受け入れ、HTML を使用して埋め込まれたプレーヤに動画 ID を渡すには、HTML 埋め込みコードの playerID の後に &@videoPlayer=12345 を追加します。ここで、12345 は、再生したい動画 ID です。これは、埋め込みコードの両方の playerID の後に追加する必要があります。

例:HTML 埋め込み:動画 ID を使用して 1 本の動画を割り当てる

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 を使用して 1 本の動画を割り当てる

単一動画を受け入れ、HTML ページに埋め込まれたプレーヤに動画の参照 ID を渡すには、HTML 埋め込みコード内のプレーヤ ID の後ろに動画の参照 ID の指定を追加します
(例: &@videoPlayer=ref:myVideo12345(myVideo12345 は再生したい動画の参照 ID))。これは、埋め込みコードの両方の playerID の後に追加する必要があります。

HTML 埋め込み:プレイリスト ID を使用してプレイリストを割り当てる

複数のプレイリストを受け入れ、HTML ページに埋め込まれたプレーヤにプレイリスト ID を渡すには、HTML 埋め込みコード内の playerID の後ろにプレイリスト ID の指定を追加します (例: &@playlistTabs=6789 または &@playlistCombo=6789 (6789 は再生したいプレイリストのプレイリスト ID))。プレイリスト ID を複数個渡す場合は、各プレイリスト ID をコンマで区切り記載します。 &@playlistTabs=6789,9876,5432

プレーヤが単一のプレイリストのみを受け入れる場合には、代わりに @videoList パラメータを使用します。
(例: &@videoList=6789).

これは、埋め込みコードの両方の playerID の後に追加する必要があります。

例:HTML 埋め込み:プレイリスト ID を使用してプレイリストを割り当てる

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 を使用してプレイリストを割り当てる

複数のプレイリストを受け入れ 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 の後に追加する必要があります。

リンク用 URL

プレーヤの URL:動画 ID を使用して 1 本の動画を割り当てる

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

プレーヤの URL:プレイリスト ID を使用してプレイリストを割り当てる

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

Related resources

コンテンツのプレーヤへの割り当てに関する詳細は、プレーヤをプログラミングセクションを参照してください。

タグ
構成パラメータ, パブリッシング コード