プレーヤ内の優先コンテンツを指定する

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

動画またはプレイリストをプレーヤに割り当てる際、その動画またはプレイリストを優先コンテンツとして指定できます。優先コンテンツとして指定した動画またはプレイリストは、そのプレーヤ内で最初に再生されます。また、そのプレーヤの動画一覧またはプレイリスト タブ一覧において先頭に表示されます。動画またはプレイリストを優先コンテンツとして指定するには、動画 ID パラメータ名またはプレイリスト ID パラメータ名の後ろに .featured を付加します。最初にコンテンツを割り当てる際に、Media モジュールを使用してコンテンツを割り当てた場合でもパラメータを指定してコンテンツを割り当てた場合でも、優先コンテンツを指定できます。

2 つの異なるプレーヤで使用したい 1 つのプレイリストがあり、一方のプレーヤではプレイリストの真ん中の動画から再生を始め、もう一方のプレーヤではプレイリストの先頭の動画から再生を始めたい場合に、この機能を使用します。プレイリストの永続的な再生順序を変更せずに、ある動画を一時的にアピールしたい場合にも、この機能を使用できます。

優先プレイリストを指定する

たとえば、次のように 3 個のプレイリストをプレーヤに割り当てているとします。

<param name="@playlistTabs" value="1234,1235,1236" />

この中で最初にロードおよび表示するプレイリストを指定するには、次のように記述します。

<param name="@playlistTabs.featured" value="1235" />

この例では、2 番目のプレイリストである 1235 を優先プレイリストとして指定しています。これにより、このプレイリスト内の動画が一覧の先頭に表示されます。

優先プレイリストとして指定したプレイリストが、そのプレーヤにまだ割り当てられていなかった場合でも、そのプレーヤに対する先頭のプレイリストになります。たとえば、3 個のプレイリスト(プレイリスト ID: 1234、1235、および 1236)をプレーヤに割り当てている状態で、次の行を追加したとします。

<param name="@playlistTabs.featured" value="4321" />

この新しいプレイリストが先頭のプレイリスト タブに表示され、このプレイリスト内の動画が最初に表示されます。

優先動画を指定する

プレーヤのロード時に優先プレイリスト内の特定の動画を最初に再生したい場合、次のように記述します。

<param name="@videoList.featured" value="3333" />

優先プレイリスト内にこの動画(動画 ID: 3333)がある場合、この動画が選択され、再生可能な状態になります。

優先コンテンツの適用例

次に示す各シナリオはすべて有効です。プレイリストを初めて割り当てる際に、パブリッシング コード内でパラメータを指定して割り当てた場合でも Media モジュールで割り当てた場合でも、結果は同じになります。

<param name="@playlistTabs" value="1234,1235,1236" /> 

<param name="@playlistTabs.featured" value="1235" />

プレーヤのロード時に、優先プレイリストとして選択した 2 番目のプレイリスト(プレイリスト ID: 1235)が選択されます。

<param name="@playlistTabs" value="1234,1235,1236" /> 

<param name="@playlistTabs.featured" value="4321" />

プレーヤのロード時に、優先プレイリストとして指定したプレイリスト(プレイリスト ID: 4321)が先頭に表示され、選択されます。割り当てられるプレイリストは合計 4 個になります。

<param name="@playlistTabs" value="1234,1235,1236" /> 

<param name="@playlistTabs.featured" value="1235" /> 
<param name="@videoList.featured" value="3333" />

優先プレイリストとして指定した 2 番目のプレイリスト(プレイリスト ID: 1235)が、デフォルトで選択されます。また、優先動画として指定した動画(動画 ID: 3333)がこの優先プレイリスト内にある場合は、その動画が選択されます。その動画がこの優先プレイリスト内にない場合は、この優先プレイリスト内の先頭の動画がデフォルトで選択されます。

<param name="@playlistTabs" value="1234,1235,1236" /> 
<param name="@playlistTabs.featured" value="4321" /> 
<param name="@videoList.featured" value="3333" />

プレーヤのロード時に、優先プレイリストとして指定したプレイリスト(プレイリスト ID: 4321)が先頭に表示され、選択されます。割り当てられるプレイリストは合計 4 個になります。優先動画として指定した動画(動画 ID: 3333)がこの優先プレイリスト内にある場合は、その動画が選択されます。その動画がこの優先プレイリスト内にない場合は、この優先プレイリスト内の先頭の動画がデフォルトで選択されます。

<param name="@playlistTabs" value="1234,1235,1236" /> 
<param name="@videoList.featured" value="3333" />

どのプレイリストも優先プレイリストとして指定していないので、先頭のプレイリストがデフォルトで表示されます。優先動画として指定した動画(動画 ID: 3333)がこのプレイリスト内にある場合は、その動画が選択されます。

ActionScript を使用して優先コンテンツを設定する

前項の説明は ActionScript を使用する場合にも当てはまります。唯一異なるのは、ActionScript パブリッシング コードでは、値を渡すのに <param name="name" value="value"> の代わりに config[param] を使用する点です。次に例を示します。

config["@playlistTabs.featured"] = 1234;
タグ
オーダ, プレーヤをプログラミング, シーケンス, 開始