サイトの動画の埋め込み設定を調整するだけでなく、さまざまなURLパラメーターを埋め込みコード内のプレーヤーURLの末尾に追加することで、Vimeoプレーヤーに機能を追加することができます。
URL パラメータは疑問符(?)で始まります。。
例えば:
`<iframe src="https://player.vimeo.com/video/76979871?embedparameter=value" width="640" height="360" frameborder="0" allowfullscreen></iframe>`
URL パラメーターは、パラメーターが追加された特定の埋め込みコードにのみ適用されます。
サポートされているプレーヤーのパラメーター
対応のプレーヤーパラメーターの概要については、以下の表を参照してください。
パラメーター | サポートされている値 | デフォルト値 | 概要 | サポートされている動画 |
オーディオトラック |
小文字の言語コード、または動画をデフォルトのメインオーディオトラックにしたい場合は「main」を使用します。
|
false | プレーヤーにデフォルトで指定されたオーディオトラックを表示します(オーディオトラックの保留が可能です)。 | 複数のオーディオトラックがアップロードされたすべての動画 |
autopause |
true , false または 1,0 |
true |
Vimeo プレーヤーは、一度に 1 つの Vimeo 動画のみを再生できるように設計されています。 したがって、複数の Vimeo 動画を同じページで再生したい場合は、このパラメーターを各動画に追加する必要があります。 ⚠️ 警告: - 自動停止機能は、Internet Explorerではサポートされていません。 - 自動停止を機能させるには、ブラウザでCookieを有効にする必要があります。 |
すべての動画 |
autoplay |
true , false または 1,0 |
false |
動画の再生を自動的に開始します。 ⚠️ 警告:iOS、Chrome 66 以降、Safari 11 以降などの一部の環境では、自動再生がブロックされることがあります。このような場合は標準再生に戻り、視聴者は再生を開始する必要があります。 |
すべての動画 |
background |
true , false または 1,0 |
false |
このパラメーターを追加すると次の効果があります:
動画がループまたは自動再生されないようにする場合は、以下のcontrols=0パラメーターを確認してください。 このパラメータを設定してもキーボードコントロールは無効になりません。 |
動画は、Starter、Standard、Advanced、Plus、Pro、Business、Premium、または Enterpriseアカウントでホスティングされる必要があります。 |
byline |
true , false または 1,0 |
サイトの 動画の埋め込み設定で 指定された値 |
動画の作成者(作者)を表示します。 |
すべての動画 (但し動画の所有者が許可した場合に限る) |
color | [hex code] | Vimeo blue- 00adef |
動画管理のカラーを指定します。 カラーは、動画の埋め込み設定によって上書きされる場合があります。 |
動画は、Starter、Standard、Advanced、Plus、Pro、Business、Premium、または Enterpriseアカウントでホスティングされる必要があります。 |
色 |
1-4 [16進コード] - カンマ区切り。 (例:colors=000000,00adef, ffffff,000000) |
色1 - プライマリ: #000000 色2-アクセント: #00adef 色3- アイコンとテキスト:#ffffff 色4 - 背景: #000000 |
プレーヤーの色を指定します。 カラーは、動画の埋め込み設定によって上書きされる場合があります。 |
動画は、Starter、Standard、Advanced、Plus、Pro、Business、Premium、または Enterpriseアカウントでホスティングされる必要があります。 |
controls |
true , false または 1,0 |
true |
このパラメーターは、chromeless体験のために、プレーヤー内のすべての要素(再生バー、共有ボタンなど)を非表示にします。
⚠️ 警告: このパラメーターを使用すると、再生/一時停止ボタンが非表示になります。視聴者の再生を開始するには、自動再生を有効にするか、キーボードコントロールを使用するか、プレーヤーSDKを実装して再生を開始およびコントロールする必要があります。 このパラメータを設定してもキーボードコントロールは無効になりません。 |
動画は、Starter、Standard、Advanced、Plus、Pro、Business、Premium、または Enterpriseアカウントでホスティングされる必要があります。 |
dnt |
true , false または 1,0 |
false |
このパラメータを「true」に設定すると、プレーヤーによるセッションデータと分析の追跡がブロックされます。 (ブラウザのトラッキングしないヘッダーを有効にした場合と同様の効果があります) ⚠️ 警告: 「トラッキングしない」が有効になっている場合、特定の必須Cookieは設定されたままになります。このような Cookie のリストはこちらで確認できます。 |
すべての動画 |
initial_quality | 240p / 360p / 540p / 720p / 1080p / 2k / 4k | auto | ビデオの品質は、アダプティブビットレートストリーミングが引き継がれる前に、再生の最初の数秒間使用されます。低品質(例:360p)に設定すると、動画の開始が速くなりますが、高品質(例:1080pや4K)に設定すると、最初から高解像度が保証されます。許容値には、360p、720p、1080p、2K、4K など、プレーヤーのメニューで利用可能な画質オプションが含まれます。 | 動画は、Starter、Standard、Advanced、Plus、Pro、Business、Premium、または Enterpriseアカウントでホスティングされる必要があります。 |
keyboard |
true, false または 1, 0 |
true |
プレーヤーイベントをトリガーするためのキーボード入力を許可します。「false」の場合、プレーヤーではキーボード入力が無視されます。どちらのモードでも、タブ入力は引き続きサポートされます。 |
すべての動画 |
loop |
true , false または 1,0 |
false |
動画の最後に達したら、無限にリプレイします。 注:ループオプションは埋め込み設定ページ内で動画の終了画面として選択することもできます。詳細については、終了画面についてをご覧ください。 |
すべての動画 |
max_quality | 240p / 360p / 540p / 720p / 1080p / 2k / 4k | auto | 動画再生中にプレーヤーが自動的に切り替えることができる最高画質。プレーヤーは、この最大値を超えない範囲で最適な再生品質を決定します。このパラメーターを設定すると帯域使用量を削減することができます。このフィールドには、動画プレーヤーの画質メニューから任意の値を選択できます。一般的な値は360p、720p、1080p、2K、4Kです。 | 動画は、Starter、Standard、Advanced、Plus、Pro、Business、Premium、または Enterpriseアカウントでホスティングされる必要があります。 |
min_quality | 240p / 360p / 540p / 720p / 1080p / 2k / 4k | auto | 動画再生中にプレーヤーが自動的に切り替えることができる最低画質。プレイヤーは、この最小値を下回ることなく再生できる最高の品質を決定します。このパラメーターを設定すると、視聴者は帯域幅を考慮しつつ、高解像度の動画を受信できます。このフィールドには、動画プレーヤーの画質メニューから任意の値を選択できます。一般的な値は360p、720p、1080p、2k、4Kです。 | 動画は、Starter、Standard、Advanced、Plus、Pro、Business、Premium、または Enterpriseアカウントでホスティングされる必要があります。 |
muted |
true , false または 1,0 |
false |
ロードの際にミュートするように動画を設定します。視聴者はプレーヤーの音量設定を調整できます。 背景の動画のミュートを解除したり、Chrome や Safari などの特定のブラウザで自動再生の制限を回避するために使用できます。 |
すべての動画 |
pip |
true , false または 1,0 |
false | コントロールバーにピクチャーインピクチャーボタンを表示し、ピクチャーインピクチャーAPIを有効にします。 | すべての動画 |
playsinline |
true , false または 1,0 |
true | フルスクリーンモードに自動的に移行するのではなく、モバイルデバイスで動画をインラインで再生します。インライン再生はすべての動画でデフォルトで有効です。 | すべての動画 |
portrait |
true , false または 1,0 |
サイトの 動画の埋め込み 設定で 指定された値 |
作成者のプロフィール画像(ポートレート)を表示します。 |
すべての動画 (但し動画の所有者が許可した場合に限る) |
プリロード | metadata、metadata_on_hover、auto、auto_on_hover、none |
metadata_ on_hover |
再生開始前のプレーヤーの読み込み動作。
これは、HTMLMediaElementインターフェースのネイティブプリロードプロパティ(https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/preload)の基本原則に従い、いくつかの追加値があります。
|
動画は、Starter、Standard、Advanced、Plus、Pro、Business、Premium、または Enterpriseアカウントでホスティングされる必要があります。 |
quality | 240p / 360p / 540p / 720p / 1080p / 2k / 4k | auto |
デフォルトでは、Vimeo プレーヤーは「自動」モードに設定されています。つまり、視聴者の帯域幅や再生環境のその他の要因に応じて最高の動画品質を選択します。 クオリティーパラメーターを使用すると、埋め込み動画のデフォルトの再生品質を指定できます。対応されていない画質を選んだ場合、クオリティーパラメーターは無視され、埋め込み動画は自動的にオートモードに設定されます。 ⚠️ 警告: - このパラメータを実装するときはご注意ください。デフォルトで4Kなどの高画質に設定すると、視聴者のバッファリングが過剰になり、再生が途切れる可能性があります。 このパラメータは、埋め込まれているアップロード済の動画とアーカイブされたイベントでのみサポートされます。ライブイベントには対応していません。 |
動画は、Starter、Standard、Advanced、Plus、Pro、Business、Premium、または Enterpriseアカウントでホスティングされる必要があります。 |
skipping_forward | true, falseまたは1, 0 | true | 埋め込み可能なプレーヤーでユーザーが早送りできるかどうか | 動画は、Starter、Standard、Advanced、Plus、Pro、Business、Premium、または Enterpriseアカウントでホスティングされる必要があります。 |
speed |
true , false または 1,0 |
false | プレーヤーの設定メニューで速度コントロールを表示し、再生レーティングAPIを有効にします。(プレーヤーAPIの詳細についてはVimeoデベロッパ:APIをご覧ください) | 動画は、Starter、Standard、Advanced、Plus、Pro、Business、Premium、または Enterpriseアカウントでホスティングされる必要があります。 |
#t | 分および秒で表される時間(例:#t=1m2s) |
動画の最初 (0m) |
特定の時点で自動的に再生を開始するために使用されます。詳細については、「特定のタイムコードで再生を開始する」をご覧ください。 注:このパラメーターは他のパラメーターのように、接頭辞の疑問符を必要としません。 |
すべての動画 |
texttrack |
小文字の言語コードと、オプションでテキストトラックのロケールとタイプ。 (例:"en"、"en-US"、"en.captions"、"en.subtitles") |
false |
プレーヤーにデフォルトで特定の cc/字幕トラックを表示します(cc /字幕トラックの保留が可能です)。
特定の動画にまだアップロードされていない言語設定を入力すると、テキストトラックパラメータは無視され、埋め込み動画はデフォルトでクローズドキャプション(CC)または字幕が無効になっている場合があります。 |
キャプションまたは字幕付きのすべての動画が利用可能です。 (注:キャプションと字幕は動画の所有者がアップロードする必要があります。詳細については、キャプションと字幕をご覧ください。) |
thumbnail_id | 動画の利用可能なサムネイルセットから読み込むサムネイルのID。 | なし | 動画の利用可能なサムネイルセットから読み込むサムネイルのIDを表示します。 | 動画は、Starter、Standard、Advanced、Plus、Pro、Business、Premium、または Enterpriseアカウントでホスティングされる必要があります。 |
title |
true , false または 1,0 |
サイトの動画の 埋め込み設定 で指定された値 |
動画のタイトルを表示します。 |
すべての動画 (但し動画の所有者が許可した場合に限る) |
transparent |
true , false または 1,0 |
true |
デフォルトでは、Vimeo のプレーヤー iframe の背景は透明です。 無効化すると、iframe の背景が黒くなります。埋め込みプレーヤーの高さと幅のサイズが動画の元のアスペクト比と一致しない場合、黒いバーがプレーヤーに適用されます。たとえば、iframe のサイズは 4:3 に設定されているのに、元の動画は 16:9 のワイドであるときなどです。 |
すべての動画 |
トランスクリプト |
true , false または 1,0
|
true | コントロールバーにトランスクリプトボタンを表示し、トランスクリプトコントロールを有効にします。 | すべての動画にテキストトラックが含まれます。 |