パラメータ | |
---|---|
|
値: 0 または 1 。デフォルトは 0 です。プレーヤーを読み込んだときに最初の動画を自動再生するかどうかを指定します。
|
|
値: 1 。デフォルトは、ユーザー設定に基づきます。1 に設定すると、ユーザーが字幕をオフにしていても、字幕がデフォルトで表示されます。
|
|
プレーヤーの動画進行バーに動画を開始してからの経過時間を示すときに使用する色を指定します。有効なパラメータ値は red と white で、デフォルトではプレーヤーの動画進行バーに赤色が使用されます。color オプションの詳細については YouTube API ブログをご覧ください。注: color パラメータを white に設定すると、modestbranding オプションが無効になります。
|
|
値: 0 、1 、または 2 。デフォルトは 1 です。動画のプレーヤー コントロールを表示するかどうかを指定します。Flash プレーヤーを読み込む埋め込み IFrame の場合、いつプレーヤーにコントロールを表示するかと、いつプレーヤーを読み込むかも定義します。
1 と 2 の場合のユーザー エクスペリエンスはまったく同じですが、controls=2 を指定すると controls=1 よりもパフォーマンスがよくなります。現在は、動画のタイトルのフォントサイズが異なるなど、2 つの値の間でプレーヤーの表示にまだ多少の相違があります。ただし、両方の値の間の相違がユーザーにまったくわからなくなった場合は、パラメータのデフォルト値が 1 から 2 に変更される可能性があります。
|
|
値: 0 または 1 。デフォルトは 0 です。1 に設定するとプレーヤーをキーボードで操作できなくなります。キーボードによる操作は次のようになります。
|
|
値: 0 または 1 。デフォルトは 0 です。このパラメータを 1 に設定すると JavaScript API が有効になります。JavaScript API とその使用方法の詳細については、JavaScript API に関するドキュメントをご覧ください。
|
|
値: 正の整数。動画の再生を停止する必要がある場合に、動画を開始してからの経過時間を秒単位で指定します。時間は動画の先頭から測定されます。start プレーヤー パラメータや startSeconds パラメータの値からではありません。これらは、動画の読み込みまたはキューイングを行うために YouTube Player API 関数で使用されるパラメータです。
|
|
値: 0 または 1 。デフォルト値は 1 です。この値を指定すると全画面表示ボタンが表示されます。このパラメータを 0 に設定すると、全画面表示ボタンは表示されなくなります。 |
|
プレーヤーのインターフェースの言語を設定します。パラメータの値は、ISO 639-1 2 文字言語コードです。ただし、IETF 言語タグ(BCP 47)などの他の言語入力コードも正しく処理されます。 インターフェースの言語はプレーヤーのツールチップで使用され、デフォルトの字幕トラックにも影響します。なお、ユーザー個別の言語設定と利用可能な字幕トラックに基づいて、YouTube が特定のユーザーに対し異なる字幕トラックを選択することもあります。 |
|
値: 1 または 3 。デフォルトは 1 です。1 に設定すると動画アノテーションがデフォルト表示されます。3 に設定すると、動画アノテーションはデフォルトで表示されなくなります。
|
|
list パラメータは、プレーヤーに読み込むコンテンツを識別するときに、listType パラメータと組み合わせて使用します。
list パラメータと listType パラメータに値を指定する場合は、IFrame 埋め込み URL に動画 ID を指定する必要はありません。
|
|
listType パラメータは、プレーヤーに読み込むコンテンツを識別するときに list パラメータと組み合わせて使用します。有効なパラメータ値は、playlist 、search および user_uploads です。list パラメータと listType パラメータに値を指定する場合は、IFrame 埋め込み URL に動画 ID を指定する必要はありません。
|
|
値: 0 または 1 。デフォルトは 0 です。単一動画プレーヤーの場合に 1 を設定すると、最初の動画が繰り返し再生されます。再生リストプレーヤーまたはカスタム プレーヤーの場合、再生リスト全体を再生した後、最初の動画から再び再生が始まります。注: このパラメータは AS3 プレーヤーと埋め込み IFrame でのみサポートされており、AS3 または HTML5 プレーヤーのいずれかが読み込まれます。 loop パラメータは、現時点では playlist パラメータと組み合わせて AS3 プレーヤーで使用した場合のみ動作します。単一の動画をループさせる場合は、loop パラメータの値を 1 に設定し、既に Player API URL に指定してある動画 ID と同じ値を playlist パラメータの値に設定します。http://www.youtube.com/v/VIDEO_ID?version=3&loop=1&playlist=VIDEO_ID |
|
このパラメータを使用すると、YouTube プレーヤーに YouTube ロゴが表示されないようにすることができます。パラメータの値を 1 に設定すると、YouTube ロゴがコントロール バーに表示されなくなります。ただし、動画を一時停止したときにユーザーがプレーヤーにカーソルを合わせると、動画の右上に引き続き小さい YouTube テキストラベルが表示されます。
|
|
このパラメータは IFrame API のセキュリティを強化します。埋め込み IFrame でのみ使用できます。IFrame API を使用している場合、つまり enablejsapi パラメータの値を 1 に設定している場合は、常に自分のドメインを origin パラメータ値として指定する必要があります。
|
|
値: 再生する動画 ID をカンマで区切ったリスト。値を指定すると、URL パスの VIDEO_ID に指定した動画が最初に再生され、playlist パラメータに指定した動画はその後に再生されます。
|
|
このパラメータは iOS 上の HTML5 プレーヤーで動画をインラインまたは全画面表示のどちらで再生するかを制御します。有効な値は次のとおりです。
|
|
値: 0 または 1 。デフォルトは 1 です。最初の動画の再生が終了したときに、プレーヤーに関連動画を表示するかどうかを指定します。
|
|
値: 0 または 1 。デフォルト値は 1 です。パラメータの値を 0 に設定すると、動画の再生が始まる前に動画のタイトルやアップロードしたユーザーなどの情報は表示されません。プレーヤーに再生リストが読み込まれる場合は、パラメータの値を明示的に 1 に設定すると、再生リストに含まれる動画のサムネイル画像も読み込み時に表示されます。AS3 プレーヤーは再生リストの読み込みができる唯一のプレーヤーであるため、この機能はこのプレーヤーでのみサポートされます。
|
|
値: 正の整数。このパラメータを指定すると、動画の先頭から指定された秒数分進めた位置から動画の再生が開始されます。seekTo 関数と同様に、プレーヤーは指定された時間に最も近いキーフレームを探します。そのため、リクエストされた時間の直前から再生が開始される場合もありますが、ずれは通常、最大で 2 秒程度です。
|
url | (required) The Vimeo URL for a video. |
api | Enable the JavaScript API. Defaults to false. |
autopause | Pause this video automatically when another one plays. Defaults to true . |
autoplay | Automatically start playback of the video. Defaults to false . |
byline | Show the byline on the video. Defaults to true . |
callback | When returning JSON, wrap in this function. |
color | Specify the color of the video controls. |
height | The exact height of the video. Defaults to original size. |
loop | Play the video again automatically when it reaches the end. Defaults to false . |
maxheight | Same as height, but video will not exceed original size. |
maxwidth | Same as width, but video will not exceed original size. |
player_id | A unique id for the player that will be passed back with all JavaScript API responses. |
portrait | Show the user’s portrait on the video. Defaults to true . |
title | Show the title on the video. Defaults to true . |
width | The exact width of the video. Defaults to original size. |
xhtml | Make the embed code XHTML compliant. Defaults to false . |