お気に入り ▼ | 日本語 ▼ | ログイン

YouTube 埋め込みプレーヤーのパラメータ

目次

  1. 概要
  2. パラメータ
    1. rel
    2. autoplay
    3. loop
    4. enablejsapi
    5. playerapiid
    6. disablekb
    7. egm
    8. border
    9. color1, color2
  3. 使用例

概要

このドキュメントでは、YouTube 埋め込みプレーヤーで使用できるすべてのパラメータについて説明します。これらのパラメータを SWF URL に追加することで、色や境界線だけでなく、プレーヤーで JavaScript API を有効にするかどうかなどを設定できます。

パラメータ

以下に示すパラメータはすべてオプションです。

rel
値: 0 または 1。デフォルトは 1 です。最初の動画の再生が始まった後に、関連する動画を読み込むかどうかを指定します。関連する動画は、[menu] ボタンをクリックするとジニー メニューに表示されます。
autoplay
値: 0 または 1。デフォルトは 0 です。プレーヤーが読み込まれたときに、最初の動画を自動再生するかどうかを指定します。
loop
値: 0 または 1。デフォルトは 0 です。1 を設定すると、単独の動画プレーヤーの場合は最初の動画が繰り返し再生されます。再生リスト プレーヤー (またはカスタム プレーヤー) の場合は、再生リスト全体が再生された後で、また最初の動画から再生が始まります。
enablejsapi
値: 0 または 1。デフォルトは 0 です。これを 1 に設定すると、Javascript API が有効になります。Javascript API とその使い方については、JavaScript API のドキュメントをご覧ください。
playerapiid
値: 英数字の文字列。この設定は、JavaScript API との組み合わせで使用します。詳しくは、JavaScript API のドキュメントをご覧ください。
disablekb
値: 0 または 1。デフォルトは 0 です。1 に設定すると、キーボードによるプレーヤーのコントロールが無効になります。キーボードによるコントロールは以下のとおりです。
     スペースバー: 再生/一時停止
     左矢印: 現在の動画を再生し直す
     右矢印: 現在の動画を 10% 先に進める
     上矢印: ボリュームを上げる
     下矢印: ボリュームを下げる
egm
値: 0 または 1。デフォルトは 0 です。1 に設定すると、「拡張ジーニー メニュー」が有効になります。この拡張によりジーニー メニューは、[menu] ボタンをクリックしたときではなく、ユーザーのマウス ポインタが動画の表示領域に入ったときに表示されるようになります (ただしジーニー メニューが存在する場合のみ)。
border
値: 0 または 1。デフォルトは 0 です。1 に設定すると、動画プレーヤーの周りに境界線が表示されます。境界線のメイン カラーは color1 パラメータで、サブ カラーは color2 パラメータで設定できます。
color1, color2
値: 16 進数形式の RGB 値。color1 は境界線のメイン カラー、color2 はコントロール バーの背景色と境界線のサブ カラーです。

使用例

上記のパラメータを使用する場合は、YouTube 動画 SWF の URL の末尾に追加します。

通常、SWF の URL は次のようになっています。

http://www.youtube.com/v/VIDEO_ID

このような URL に、YouTube Data API を使用してプログラム的にアクセスするには、yt:format=5 <media:content> URL を探します。動画をアップロードしたユーザーが埋め込みを無効にしている場合は、このような形式を使用することはできません。

<media:content url="http://www.youtube.com/v/VIDEO_ID" type="application/x-shockwave-flash" medium="video" 
          isDefault="true" expression="full" duration="100" yt:format="5"/>

カラー テーマを青色系に変えるには、2 つの color パラメータを変更します。

http://www.youtube.com/v/VIDEO_ID&color1=0x2b405b&color2=0x6b8ab6

変更が完了したら、その URL をコードに埋め込みます。

<object width="425" height="355">
  <param name="movie" value="http://www.youtube.com/v/u1zgFlCw8Aw&rel=1&color1=0x2b405b&
    color2=0x6b8ab6&border=1"></param>
  <param name="wmode" value="transparent"></param>
  <embed src="http://www.youtube.com/v/u1zgFlCw8Aw&rel=1&color1=0x2b405b&color2=0x6b8ab6&border=1"
    type="application/x-shockwave-flash" wmode="transparent" width="425" height="355"></embed>
</object>

下のように青色系の境界線が表示されるよう、rel、color1、color2、および border パラメータが変更されています。rel パラメータが 1 に設定されているため、[menu] ボタンをクリックすると関連する動画も表示されます。


トップへ戻る