fancyBox - YouTube, Vimeo 動画URLパラメータによる動画制御 - Video parameters(デモ)

YouTube/Vimeo パラメータ一覧

YouTubeVimeo

▼ YouTubeパラメータ一覧
パラメータ

autoplay

値: 0 または 1。デフォルトは 0 です。プレーヤーを読み込んだときに最初の動画を自動再生するかどうかを指定します。

cc_load_policy

値: 1。デフォルトは、ユーザー設定に基づきます。1 に設定すると、ユーザーが字幕をオフにしていても、字幕がデフォルトで表示されます。

color

プレーヤーの動画進行バーに動画を開始してからの経過時間を示すときに使用する色を指定します。有効なパラメータ値は redwhite で、デフォルトではプレーヤーの動画進行バーに赤色が使用されます。color オプションの詳細については YouTube API ブログをご覧ください。

注: color パラメータを white に設定すると、modestbranding オプションが無効になります。

controls

値: 01、または 2。デフォルトは 1 です。動画のプレーヤー コントロールを表示するかどうかを指定します。Flash プレーヤーを読み込む埋め込み IFrame の場合、いつプレーヤーにコントロールを表示するかと、いつプレーヤーを読み込むかも定義します。

  • controls=0 ? プレーヤーにプレーヤー コントロールは表示されません。埋め込み IFrame の場合は、Flash プレーヤーがすぐに読み込まれます。
  • controls=1 ? プレーヤーにプレーヤー コントロールが表示されます。埋め込み IFrame の場合は、コントロールがすぐに表示され、Flash プレーヤーもすぐに読み込まれます。
  • controls=2 ? プレーヤーにプレーヤー コントロールが表示されます。埋め込み IFrame の場合は、ユーザーが動画の再生を開始した後にコントロールが表示され、Flash プレーヤーが読み込まれます。

注: 埋め込み IFrame の場合は、パラメータ値が 12 の場合のユーザー エクスペリエンスはまったく同じですが、controls=2 を指定すると controls=1 よりもパフォーマンスがよくなります。現在は、動画のタイトルのフォントサイズが異なるなど、2 つの値の間でプレーヤーの表示にまだ多少の相違があります。ただし、両方の値の間の相違がユーザーにまったくわからなくなった場合は、パラメータのデフォルト値が 1 から 2 に変更される可能性があります。

disablekb

値: 0 または 1。デフォルトは 0 です。1 に設定するとプレーヤーをキーボードで操作できなくなります。キーボードによる操作は次のようになります。

  • スペースキー: 再生 / 一時停止
  • 左矢印キー: 現在の動画を 10% 戻す
  • 右矢印キー: 現在の動画を 10% 進める
  • 上矢印キー: 音量を上げる
  • 下矢印キー: 音量を下げる

enablejsapi

値: 0 または 1。デフォルトは 0 です。このパラメータを 1 に設定すると JavaScript API が有効になります。JavaScript API とその使用方法の詳細については、JavaScript API に関するドキュメントをご覧ください。

end

値: 正の整数。動画の再生を停止する必要がある場合に、動画を開始してからの経過時間を秒単位で指定します。時間は動画の先頭から測定されます。start プレーヤー パラメータや startSeconds パラメータの値からではありません。これらは、動画の読み込みまたはキューイングを行うために YouTube Player API 関数で使用されるパラメータです。

fs

値: 0 または 1。デフォルト値は 1 です。この値を指定すると全画面表示ボタンが表示されます。このパラメータを 0 に設定すると、全画面表示ボタンは表示されなくなります。

hl

プレーヤーのインターフェースの言語を設定します。パラメータの値は、ISO 639-1 2 文字言語コードです。ただし、IETF 言語タグ(BCP 47)などの他の言語入力コードも正しく処理されます。

インターフェースの言語はプレーヤーのツールチップで使用され、デフォルトの字幕トラックにも影響します。なお、ユーザー個別の言語設定と利用可能な字幕トラックに基づいて、YouTube が特定のユーザーに対し異なる字幕トラックを選択することもあります。

iv_load_policy

値: 1 または 3。デフォルトは 1 です。1 に設定すると動画アノテーションがデフォルト表示されます。3 に設定すると、動画アノテーションはデフォルトで表示されなくなります。

list

list パラメータは、プレーヤーに読み込むコンテンツを識別するときに、listType パラメータと組み合わせて使用します。

  • listType パラメータの値が search の場合は、list パラメータの値に検索クエリを指定します。
  • listType パラメータの値が user_uploads の場合、list パラメータの値には、読み込まれるアップロード動画の所有者の YouTube チャンネルを指定します。
  • listType パラメータの値が playlist の場合は、list パラメータの値に YouTube 再生リスト ID を指定します。パラメータ値に含める再生リスト ID には、下の例に示すように、PL という文字を先頭に付ける必要があります。
    http://www.youtube.com/embed?listType=playlist&list=PLC77007E23FF423C6

注: list パラメータと listType パラメータに値を指定する場合は、IFrame 埋め込み URL に動画 ID を指定する必要はありません。

listType

listType パラメータは、プレーヤーに読み込むコンテンツを識別するときに list パラメータと組み合わせて使用します。有効なパラメータ値は、playlistsearch および user_uploads です。

list パラメータと listType パラメータに値を指定する場合は、IFrame 埋め込み URL に動画 ID を指定する必要はありません。

loop

値: 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

modestbranding

このパラメータを使用すると、YouTube プレーヤーに YouTube ロゴが表示されないようにすることができます。パラメータの値を 1 に設定すると、YouTube ロゴがコントロール バーに表示されなくなります。ただし、動画を一時停止したときにユーザーがプレーヤーにカーソルを合わせると、動画の右上に引き続き小さい YouTube テキストラベルが表示されます。

origin

このパラメータは IFrame API のセキュリティを強化します。埋め込み IFrame でのみ使用できます。IFrame API を使用している場合、つまり enablejsapi パラメータの値を 1 に設定している場合は、常に自分のドメインを origin パラメータ値として指定する必要があります。

playlist

値: 再生する動画 ID をカンマで区切ったリスト。値を指定すると、URL パスの VIDEO_ID に指定した動画が最初に再生され、playlist パラメータに指定した動画はその後に再生されます。

playsinline

このパラメータは iOS 上の HTML5 プレーヤーで動画をインラインまたは全画面表示のどちらで再生するかを制御します。有効な値は次のとおりです。

  • 0: この値を指定すると全画面表示で再生されます。現時点ではこれがデフォルト値ですが、デフォルトは変更される場合があります。
  • 1: この値を指定すると、UIWebViewsallowsInlineMediaPlayback プロパティを TRUE に設定して作成したもの)がインライン再生されます。

rel

値: 0 または 1。デフォルトは 1 です。最初の動画の再生が終了したときに、プレーヤーに関連動画を表示するかどうかを指定します。

showinfo

値: 0 または 1。デフォルト値は 1 です。パラメータの値を 0 に設定すると、動画の再生が始まる前に動画のタイトルやアップロードしたユーザーなどの情報は表示されません。

プレーヤーに再生リストが読み込まれる場合は、パラメータの値を明示的に 1 に設定すると、再生リストに含まれる動画のサムネイル画像も読み込み時に表示されます。AS3 プレーヤーは再生リストの読み込みができる唯一のプレーヤーであるため、この機能はこのプレーヤーでのみサポートされます。

start

値: 正の整数。このパラメータを指定すると、動画の先頭から指定された秒数分進めた位置から動画の再生が開始されます。seekTo 関数と同様に、プレーヤーは指定された時間に最も近いキーフレームを探します。そのため、リクエストされた時間の直前から再生が開始される場合もありますが、ずれは通常、最大で 2 秒程度です。
▼ Vimeoパラメータ一覧
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.