この記事では、埋め込みコード内のURLパラメーターを使用して、対象動画に特定の機能が追加されるようにVimeoプレーヤーをカスタマイズする方法について説明しています。
サイト上の動画の埋め込み設定を調整する以外にも、埋め込みコード内のプレーヤーURLの末尾にさまざまなURLパラメーターを追加することで、Vimeoプレーヤーの機能を強化できます。
URL パラメータは疑問符（？）で始まります。。
例：
`<iframe src="https://player.vimeo.com/video/76979871?embedparameter=value" width="640" height="360" frameborder="0" allowfullscreen></iframe>`
URL パラメーターは、パラメーターが追加された特定の埋め込みコードにのみ適用されます。
サポートされているプレーヤーのパラメーター
対応のプレーヤーパラメーターの概要については、以下の表を参照してください。
| パラメーター | サポートされている値 | デフォルト値 | 概要 | サポートされている動画 |
| AirPlay |
true , false または 1,0 |
true | AirPlayが有効であるかどうか。 | 動画は、Starter、Standard、Advanced、Plus、Pro、Business、Premium、またはEnterpriseアカウントでホスティングされる必要があります。 ⚠️注：AirPlayはSafariでのみサポートされています。 |
| ask_ai | autopause | true | Ask AI機能が有効になっているかどうか。 | Enterpriseアカウントでホストされる動画のうち、Ask AI機能の対象となるもの。 |
| オーディオトラック |
true , false または 1,0 |
true | オーディオメニューが表示されるかどうか。 | 動画は、Starter、Standard、Advanced、Plus、Pro、Business、Premium、または Enterpriseアカウントでホスティングされる必要があります。 |
| オーディオトラック |
小文字の言語コード、または動画をデフォルトのメインオーディオトラックにしたい場合は「main」を使用します。
|
false | プレーヤーにデフォルトで指定されたオーディオトラックを表示します（オーディオトラックの保留が可能です）。 | 複数のオーディオトラックがアップロードされたすべての動画 |
| autopause |
true , false または 1,0 |
true |
Vimeoプレーヤーでは一度に 1 つの動画のみ再生できます。同じページに複数の動画を配置するには、それぞれに特定のパラメーターを追加する必要があります。 ⚠️ 注：自動一時停止機能を利用するには、ブラウザでCookieを有効にする必要があります。 |
すべての動画 |
| autoplay |
true , false または 1,0 |
false | 動画の再生を自動的に開始します。 | すべての動画 |
| background |
true , false または 1,0 |
false |
このパラメーターを追加すると、次のようになります。
ループまたは自動再生を防止するには、controls=0 パラメーターを使用します。 このパラメーターを設定しても、キーボード操作は無効になりません。 |
動画は、Starter、Standard、Advanced、Plus、Pro、Business、Premium、または Enterpriseアカウントでホスティングされる必要があります。 |
| バッジ |
true , false または 1,0 |
true | 動画のバッジを表示（例：スタッフピックバッジ）。 | すべての動画 |
| byline |
true , false または 1,0 |
サイトの 動画の埋め込み設定で 指定された値 |
動画の作成者（作者）を表示します。 | すべての動画 |
| CC |
true , false または 1,0 |
true | クローズドキャプションボタンが有効になっているかどうか。 | 動画は、Starter、Standard、Advanced、Plus、Pro、Business、Premium、または Enterpriseアカウントでホスティングされる必要があります。 |
| チャプター |
true , false または 1,0 |
true | チャプターボタンが表示されるかどうか。 | 動画は、Starter、Standard、Advanced、Plus、Pro、Business、Premium、または Enterpriseアカウントでホスティングされる必要があります。 |
| Chromecast |
true , false または 1,0 |
true | Chromecast ボタンが表示されるかどうか。 |
動画は、Starter、Standard、Advanced、Plus、Pro、Business、Premium、またはEnterpriseアカウントでホスティングされる必要があります。 ⚠️注：ChromecastはiOSには対応していません |
| 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 | 再生バーや共有ボタンなど、すべてのプレーヤー要素を非表示または表示して、一般ブラウザとはひと味違った体験を提供します。 注：有効にすると、再生/一時停止ボタンは非表示になります。視聴者が再生を開始・操作するには、自動再生、キーボード操作、またはVimeoのプレーヤーSDKを使用する必要があります。 この設定では、キーボード操作は無効になりません。 |
動画は、Starter、Standard、Advanced、Plus、Pro、Business、Premium、または Enterpriseアカウントでホスティングされる必要があります。 |
| dnt |
true , false または 1,0 |
false |
「true」に設定すると、プレーヤーによるセッションデータと分析データの収集がブロックされます。ブラウザで「トラッキング拒否」機能をアクティブにする場合と類似する効果が得られます。 ⚠️ 注意：「トラッキング拒否」を有効にしても、一部の必須Cookieはアクティブなままとなります。このリストを表示するには、「VimeoプレーヤーのCookie」をご覧ください。 |
すべての動画 |
| 全画面 |
true , false または 1,0 |
true | フルスクリーンボタンが表示されるかどうか。 | 動画は、Starter、Standard、Advanced、Plus、Pro、Business、Premium、または Enterpriseアカウントでホスティングされる必要があります。 |
| initial_quality | 240p / 360p / 540p / 720p / 1080p / 2k / 4k | auto |
アダプティブストリーミングの開始前に一時的に表示される初期の動画品質。 このパラメーターは読み込みを速くしたり明度を高めたりするために調整可能です。 360pなどの低画質は読み込みが速く、1080pや 4Kなどの高画質はすぐに優れた解像度を提供します。 |
動画は、Starter、Standard、Advanced、Plus、Pro、Business、Premium、または Enterpriseアカウントでホスティングされる必要があります。 |
| インタラクティブパラメータ | カンマ区切りのキーと値のペア | なし | 動的要素のあるインタラクティブ動画で活用されるキーと値のペアで示される動的パラメーター。title=my-video、subtitle=interactiveなどの例があります。 | インタラクティブ動画 |
| インタラクティブマーカー |
true , false または 1,0 |
true | インタラクティブ動画でホットスポットを示すタイムスタンプを表すマーカーを表示するかどうか。 | インタラクティブ動画 |
| 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を有効にします。 | 動画は、Starter、Standard、Advanced、Plus、Pro、Business、Premium、またはEnterpriseアカウントでホスティングされる必要があります。 |
| play_button_position | 自動、下、または中央 | auto | プレーヤー上の再生ボタンの位置。自動に設定すると、再生ボタンは小さいブレークポイントでプレーヤーの中央に移動する前に、コントロールバーに表示されます。 | 動画は、Starter、Standard、Advanced、Plus、Pro、Business、Premium、またはEnterpriseアカウントでホスティングされる必要があります。 |
| playsinline |
true , false または 1,0 |
true | フルスクリーンモードに自動的に移行するのではなく、モバイルデバイスで動画をインラインで再生します。インライン再生はすべての動画でデフォルトで有効です。 | すべての動画 |
| portrait |
true , false または 1,0 |
サイトの 動画の埋め込み 設定で 指定された値 |
作者のプロフィール画像（ポートレート）を表示します。 | すべての動画 |
| プリロード | metadata、metadata_on_hover、auto、auto_on_hover、none |
metadata_ on_hover |
プレーヤーの再生前の読み込み動作は、HTMLMediaElementインターフェースのネイティブプリロードプロパティと一致し、次のいくつかのオプションが追加されます。
事前に読み込むデータ量を増やすほど、動画の起動が速くなります。そのため、「auto」と「auto_on_hover」を使用すると、起動は速くなりますが、ユーザーが動画を再生しているかどうかが動画セグメントにより読み込まれるため、必要な帯域幅は増えます。Vimeoの帯域幅制限の詳細については、「Vimeoの帯域幅」をご覧ください。 |
動画は、Starter、Standard、Advanced、Plus、Pro、Business、Premium、または Enterpriseアカウントでホスティングされる必要があります。 |
| プログレスバー |
true , false または 1,0 |
true | プログレスバーが表示されるかどうか。 | 動画は、Starter、Standard、Advanced、Plus、Pro、Business、Premium、または Enterpriseアカウントでホスティングされる必要があります。 |
| quality | 240p / 360p / 540p / 720p / 1080p / 2k / 4k | auto |
デフォルトでは、Vimeoプレーヤーは「Auto」モードに設定されており、視聴者の帯域幅や再生環境の他の要因に基づいて、可能な限り最高の動画品質を選択します。 画質パラメーターを使用して、埋め込み動画のデフォルト再生解像度を指定できます。利用できない画質を選択した場合、パラメーターは無視され、埋め込みは自動的に「自動」に設定されます。 💡ヒント：高画質設定（4Kなど）を選択すると、視聴者にバッファリングが多発し、再生が途切れる可能性があります。 |
動画は、Starter、Standard、Advanced、Plus、Pro、Business、Premium、または Enterpriseアカウントでホスティングされる必要があります。 アップロードされた動画とアーカイブされたイベントに利用可能です。ライブイベントはサポートしていません。 |
| クオリティセレクター |
true , false または 1,0 |
true | 品質セレクターメニューが表示されるかどうか。 | 動画は、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/字幕トラックをプレイヤーにデフォルトで表示します。 動画にまだアップロードされていない言語設定を選択した場合、テキストトラック設定は無視され、埋め込み動画はデフォルトでキャプションまたは字幕がオフになった状態で読み込まれる可能性があります。 |
キャプションまたは字幕付きのすべての動画が利用可能です。 （注：キャプションと字幕は動画の所有者がアップロードする必要があります。詳細については、キャプションと字幕をご覧ください。） |
| 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 | コントロールバーにトランスクリプトボタンを表示し、トランスクリプトコントロールを有効にします。 | 動画は、Starter、Standard、Advanced、Plus、Pro、Business、Premium、または Enterpriseアカウントでホスティングされる必要があります。 |
| ミュート解除ボタン |
true , false または 1,0 |
true | ミュート解除ボタンが表示されるかどうか。 | 動画は、Starter、Standard、Advanced、Plus、Pro、Business、Premium、または Enterpriseアカウントでホスティングされる必要があります。 |
| vimeo_logo |
true , false または 1,0 |
true | Vimeoのロゴが表示されるかどうか。 | 動画は、Starter、Standard、Advanced、Plus、Pro、Business、Premium、または Enterpriseアカウントでホスティングされる必要があります。 |
| 音量 |
true , false または 1,0 |
true | 音量コントロールが表示されるかどうか。 | 動画は、Starter、Standard、Advanced、Plus、Pro、Business、Premium、または Enterpriseアカウントでホスティングされる必要があります。 |
| watch_full_video |
true , false または 1,0 |
true | 動画にセグメント再生モードで「動画全編を視聴」ボタンが表示されるかどうか。 | すべての動画はセグメント再生モードで再生されます。 |