サイトの動画の埋め込み設定を調整するだけでなく、さまざまなURLパラメーターを埋め込みコード内のプレーヤーURLの末尾に追加することで、Vimeoプレーヤーに機能を追加することができます。
URL パラメーターは疑問符（?）で始まります。以下に例を示します。
<iframe src="https://player.vimeo.com/video/76979871?embedparameter=value" width="640" height="360" frameborder="0" allowfullscreen></iframe>
URLパラメーターは、パラメーターが追加された特定の埋め込みコードにのみ適用されます。
サポートされているプレーヤーのパラメーター
対応のプレーヤーパラメーターの概要については、以下の表を参照してください。
| パラメーター | サポートされている値 | デフォルト値 | 概要 | サポートされている動画 |
|---|---|---|---|---|
|
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- |
動画管理のカラーを指定します。 |
動画は、Starter、Standard、Advanced、Plus、Pro、Business、Premium、または Enterpriseアカウントでホスティングされる必要があります。 |
|
色
|
1-4 [16進コード] - カンマ区切り。 （例：colors=000000,00adef, ffffff,000000） |
色1 - プライマリ: #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 のリストはこちらで確認できます。 |
すべての動画 |
|
keyboard |
true / false |
true |
プレーヤーイベントをトリガーするためのキーボード入力を許可します。「false」の場合、プレーヤーではキーボード入力が無視されます。どちらのモードでも、タブ入力は引き続きサポートされます。 |
すべての動画 |
|
loop |
true , false または 1,0 |
false |
動画の最後に達したら、無限にリプレイします。 注：ループは埋め込み設定ページ内の動画の終了画面としても選択できます。詳細はこちら。 |
すべての動画 |
|
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 |
サイトの動画の埋め込み設定で指定された値 |
作成者のプロフィール画像（ポートレート）を表示します。 |
すべての動画 （但し動画の作者が許可した場合に限る） |
|
quality |
240p / 360p / 540p / 720p / 1080p / 2k / 4k |
auto |
デフォルトでは、Vimeo プレーヤーは「自動」モードに設定されています。つまり、視聴者の帯域幅や再生環境のその他の要因に応じて最高の動画品質を選択します。 クオリティーパラメーターを使用すると、埋め込み動画のデフォルトの再生品質を指定できます。対応されていない画質を選んだ場合、クオリティーパラメーターは無視され、埋め込み動画は自動的にオートモードに設定されます。 ⚠️ 警告： - このパラメータを実装するときはご注意ください。デフォルトで4Kなどの高画質に設定すると、視聴者のバッファリングが過剰になり、再生が途切れる可能性があります。 - このパラメータは、埋め込まれているアップロード済の動画とアーカイブされたイベントでのみサポートされます。ライブイベントには対応しておりません。 |
動画は、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） |
動画の最初 |
特定の時点で自動的に再生を開始するために使用されます。詳しくは、 「特定のタイムコードで再生を開始する」をご覧ください。 注：このパラメーターは他のパラメーターのように、接頭辞の疑問符を必要としません。 |
すべての動画 |
|
texttrack |
小文字の言語コードと、オプションでテキストトラックのロケールとタイプ。 （例："en"、"en-US"、"en.captions"、"en.subtitles"） |
false |
プレーヤーにデフォルトで特定の cc/字幕トラックを表示します（cc /字幕トラックの保留が可能です）。
特定の動画にまだアップロードされていない言語設定を入力すると、テキストトラックパラメータは無視され、埋め込み動画はデフォルトでCCまたは字幕が無効になっている場合があります。 |
キャプションまたは字幕付きのすべての動画が利用可能です。 （注：キャプションと字幕は動画の所有者がアップロードする必要があります）詳細については、キャプションと字幕をご覧ください） |
|
title |
true , false または 1,0 |
サイトの動画の埋め込み設定で指定された値 |
動画のタイトルを表示します。 |
すべての動画 （但し動画の所有者が許可した場合に限る） |
|
transparent |
true , false または 1,0 |
true |
デフォルトでは、プレーヤーの iframe の背景は Vimeo 上では透明です。 無効化すると、iframe の背景が黒くなります。埋め込みプレーヤーの高さと幅のサイズが動画の元のアスペクト比と一致しない場合、黒いバーがプレーヤーに適用されます。たとえば、iframe のサイズは 4:3 に設定されているのに、元の動画は 16:9 のワイドであるときなどです。 |
すべての動画 |
|
トランスクリプト |
true , false または 1,0
|
true |
コントロールバーにトランスクリプトボタンを表示し、トランスクリプトコントロールを有効にします。 |
すべての動画にテキストトラックが含まれます。 |