사이트에서 동영상의 임베딩 설정을 조정할 수 있을 뿐 아니라, 다양한 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 플레이어는 한 번에 하나의 Vimeo 동영상만 재생하도록 설계되어 있습니다. 따라서, 한 페이지에서 둘 이상의 Vimeo 동영상을 재생하려면 각 동영상에 이 매개변수를 추가해야 합니다. ⚠️경고: - Internet Explorer 11 및 이전 버전에서는 자동 일시 중지 기능이 지원되지 않습니다. - 자동 일시 중지가 작동하려면 브라우저에서 쿠키를 활성화해야 합니다. |
모든 동영상 |
|
autoplay |
true , false 또는 1,0 |
false |
자동으로 동영상 재생을 시작합니다. ⚠️ 경고: IOS, Chrome 66+, Safari 11+ 등 일부 환경에서는 자동 재생이 차단될 수 있습니다. 이 경우, 시청자가 재생을 시작해야 하는 표준 재생으로 전환합니다. |
모든 동영상 |
|
background |
true , false 또는 1,0 |
false |
이 매개변수를 추가하면 다음 변화가 적용됩니다:
동영상이 반복되거나 자동 재생되지 않도록 하려면 아래 controls=0 매개변수를 확인하세요. 이 매개변수를 설정해도 키보드 컨트롤은 비활성화되지 않습니다. |
동영상은 Plus 계정 이상으로 호스팅해야 합니다. |
|
byline |
true , false 또는 1,0 |
사이트의 |
동영상 만든이를 표시합니다. (창작가 표시) |
모든 동영상 (동영상 소유자가 허용하는 경우에만) |
|
color |
[hex code] |
Vimeo blue- |
동영상 컨트롤의 색상을 지정합니다. 색상은 동영상의 임베딩 설정에 의해 재정의될 수 있습니다. |
동영상은 Plus 계정 이상으로 호스팅해야 합니다. |
|
controls |
true , false 또는 1,0 |
true |
이 매개변수는 크롬리스 경험을 위해 플레이어의 모든 요소 (플레이바, 공유 버튼 등)를 숨깁니다.
⚠️경고: 이 매개변수를 사용하면 재생/일시 중지 버튼이 숨겨집니다. 시청자를 위해 재생을 시작하려면 자동 재생을 활성화하거나 키보드 컨트롤을 사용하거나 플레이어 SDK를 구현하여 재생을 시작하고 제어해야 합니다. 이 매개변수를 설정해도 키보드 컨트롤은 비활성화되지 않습니다. |
동영상은 Plus 이상 계정에서 호스팅해야 합니다. |
|
dnt |
true , false 또는 1,0 |
false |
이 매개변수를 'true'로 설정하면 플레이어가 모든 쿠키와 애널리틱스 및 모든 세션 데이터를 추적하지 못합니다. (브라우저에서 추적 안 함 설정을 활성화하는 것과 동일한 효과가 발생합니다.) |
모든 동영상 |
|
loop |
true , false 또는 1,0 |
false |
끝에 도달하면 무한으로 동영상을 다시 재생합니다. 참고: 반복재생은 임베딩 설정 페이지에서 동영상의 종료 화면으로 선택할 수도 있습니다. 여기에서 자세히 알아보세요. |
모든 동영상 |
|
muted |
true , false 또는 1,0 |
false |
로드 시 동영상을 음소거하도록 설정합니다. 시청자가 플레이어에서 볼륨 기본 설정을 조정할 수도 있습니다. Chrome이나 Safari 등 특정 브라우저에서 배경 동영상을 음소거 해제하거나 자동 재생 제한을 조정하는 데 사용할 수 있습니다. |
모든 동영상 |
|
pip
|
true, false 또는 1,0 |
false |
컨트롤 바에 PIP (Picture-in-Picture) 버튼을 표시하고 PIP API를 활성화합니다. |
모든 동영상 |
|
playsinline |
true , false 또는 1,0 |
true |
동영상이 자동으로 전체 화면 모드로 전환되는 대신 모바일 기기에서 인라인으로 재생됩니다. 인라인 재생은 모든 동영상에서 기본적으로 활성화되어 있습니다. |
모든 동영상 |
|
portrait |
true , false 또는 1,0 |
사이트의 |
만든이의 프로필 이미지를 표시합니다(포트레이트). |
모든 동영상 (동영상 소유자가 허용하는 경우에만) |
|
quality |
240p, 360p, 540p, 720p, 1080p, 2k, 4k |
auto |
기본적으로 Vimeo 플레이어는 "자동" 모드로 설정되어 있습니다. 즉, 시청자의 대역폭과 재생 환경의 여러 요인들에 따라 가능한 최고 수준의 동영상 품질을 선택합니다. 품질 매개변수를 사용하면 임베딩된 동영상에 대해 기본 재생 품질을 지정할 수 있습니다. 특정 동영상에 존재하지 않는 품질을 선택하면 품질 매개변수가 무시되고 임베딩 동영상의 기본값이 Auto로 자동 설정됩니다. ⚠️경고: - 이 매개변수는 모바일 기기 또는 태블릿에서 지원되지 않습니다. - 이 매개변수를 구현할 때 주의하세요. 더 높은 품질 (예: 4K)로 기본값을 설정하면 시청자에게 과도한 버퍼링 및 끊김 현상이 발생할 수 있습니다. - 이 매개변수는 업로드된 동영상 및 임베드된 아카이브 이벤트에만 지원됩니다. 라이브 이벤트에는 지원되지 않습니다. |
동영상은 Plus 계정 이상으로 호스팅해야 합니다. |
|
speed |
true , false 또는 1,0 |
false |
플레이어의 기본 설정 메뉴에서 속도 컨트롤을 표시하고 재생 속도 API를 활성화합니다. (플레이어 API에 관한 자세한 내용은 여기에서 알아보세요) |
동영상은 Pro 계정 이상으로 호스팅해야 합니다. |
|
#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 와이드인 경우) 검정색 막대가 플레이어에 적용됩니다. |
모든 동영상 |
여러 개의 임베드 매개변수 사용하기
같은 임베딩 코드에 여러 개의 매개변수를 추가하는 경우, 앰퍼샌드 (&)로 각각을 구분해야 합니다. 예를 들어:
<iframesrc="https://player.vimeo.com/video/76979871?autoplay=1&loop=1&muted=1" width="640" height="360" frameborder="0"webkitallowfullscreen mozallowfullscreen allowfullscreen></iframe>
Vimeo.com URL에 임베드 매개변수 적용하기
임베딩 코드 대신 Vimeo.com URL을 삽입해야 하는 애플리케이션을 사용하는 경우에는 (예: https://vimeo.com/
예를 들어, 이 방법은 지원되지 않습니다 :
https://vimeo.com/76979871?
이 방법은 지원됩니다:
<iframe src="https://player.vimeo.com/
Vimeo URL만 지원하는 애플리케이션 일부 예시로는 소셜 미디어 게시물, Wordpress 테마 및 플러그인, Wix 플러그인, Squarespace 플러그인, 웹페이지 빌더 내의 다른 기타 동영상 임베딩 도구가 있습니다. 좋은 소식으로는, 일부 도구를 통해 자체 UI에서 플레이어 기본 설정(예: 자동 재생)을 직접 조정할 수 있습니다.