사이트에서 동영상의 임베딩 설정을 조정할 수 있을 뿐 아니라, 다양한 URL 매개변수를 임베딩 코드에 있는 플레이어 URL 뒤에 추가해서 Vimeo 플레이어에 기능을 추가할 수도 있습니다.
URL 매개변수는 물음표(?)로 시작됩니다. 예를 들어:
<iframe src="https://player.vimeo.com/video/76979871?embedparameter=value" width="640" height="360" frameborder="0" allowfullscreen></iframe>
URL 매개변수는 매개변수가 추가된 특정 임베딩 코드에만 적용됩니다.
지원되는 플레이어 매개변수
매개변수 | 지원되는 값 | 기본값 | 설명 | 지원되는 동영상 |
---|---|---|---|---|
autoplay |
true , false 또는 1,0 |
false |
자동으로 동영상 재생을 시작합니다. ⚠️ 경고: IOS, Chrome 66+, Safari 11+ 등 일부 환경에서는 자동 재생이 차단될 수 있습니다. 이 경우, 시청자가 재생을 시작해야 하는 표준 재생으로 전환합니다. |
모든 동영상 |
loop |
true , false 또는 1,0 |
false |
끝에 도달하면 무한으로 동영상을 다시 재생합니다. 참고: 반복재생은 임베딩 설정 페이지에서 동영상의 종료 화면으로 선택할 수도 있습니다. 여기에서 자세히 알아보세요. |
모든 동영상 |
color |
[hex code] |
Vimeo blue- |
동영상 컨트롤의 색상을 지정합니다. 색상은 동영상의 임베딩 설정에 의해 재정의될 수 있습니다. |
동영상은 Plus 계정 이상으로 호스팅해야 합니다. |
byline |
true , false 또는 1,0 |
사이트의 |
동영상 만든이를 표시합니다(창작가 표기 행). |
모든 동영상 (동영상 소유자가 허용하는 경우에만) |
portrait |
true , false 또는 1,0 |
사이트의 |
만든이의 프로필 이미지를 표시합니다(포트레이트). |
모든 동영상 (동영상 소유자가 허용하는 경우에만) |
title |
true , false 또는 1,0 |
사이트의 |
동영상 제목을 표시합니다. |
모든 동영상 (동영상 소유자가 허용하는 경우에만) |
speed |
true , false 또는 1,0 |
false |
플레이어의 기본 설정 메뉴에서 속도 컨트롤을 표시하고 재생 속도 API를 활성화합니다. (플레이어 API에 관한 자세한 내용은 여기에서 알아보세요) |
동영상은 PRO 계정 이상으로 호스팅해야 합니다. |
fun |
true , false 또는 1,0 |
true |
비활성화되면 플레이어에서 이상한 오류 메시지를 제거합니다(예: Oops, Fiddlesticks) |
모든 동영상 |
autopause |
true , false 또는 1,0 |
true |
Vimeo 플레이어는 한 번에 하나의 Vimeo 동영상만 재생하도록 설계되어 있습니다. 따라서, 한 페이지에서 둘 이상의 Vimeo 동영상을 재생하려면 각 동영상에 이 매개변수를 추가해야 합니다. ⚠️ 경고: Internet Explorer 11 및 이전 버전에서는 자동 일시 정지 기능이 지원되지 않습니다. |
모든 동영상 |
background |
true , false 또는 1,0 |
false |
이 매개변수를 추가하면 다음 변화가 적용됩니다:
*다른 매개변수를 사용하여 자동 재생 및 반복 재생을 비활성화할 수 없습니다. |
동영상은 Plus 계정 이상으로 호스팅해야 합니다. |
quality |
360p, 540p, 720p, 1080p,2k, 4k |
auto |
기본적으로 Vimeo 플레이어는 "자동" 모드로 설정되어 있습니다. 즉, 시청자의 대역폭과 재생 환경의 여러 요인들에 따라 가능한 최고 수준의 동영상 품질을 선택합니다. 품질 매개변수를 사용하면 임베딩된 동영상에 대해 기본 재생 품질을 지정할 수 있습니다. 특정 동영상에 존재하지 않는 품질을 선택하면 품질 매개변수가 무시되고 임베딩 동영상의 기본값이 Auto로 자동 설정됩니다. ⚠️ 경고: 이 매개변수를 구현할 때는 주의하세요. 특정 품질을 기본 설정으로 정하면 시청자는 심한 버퍼링과 재생 시 끊김 현상을 겪을 수 있습니다. 모든 시청자가 고화질 동영상(특히 2K, 4K)을 지원하는 대역폭을 사용하는 것은 아닙니다. |
동영상은 Plus 계정 이상으로 호스팅해야 합니다. |
transparent |
true , false 또는 1,0 |
true |
기본적으로 플레이어 iframe의 배경은 Vimeo에서 투명입니다. 비활성화하면 iframe 배경이 다시 검정색이 됩니다. 임베딩된 플레이어에 대한 높이 및 너비 치수가 동영상의 기존 종횡비와 일치하지 않는 경우에는(예: iframe 치수가 4:3 사각형으로 설정되었으나 원본 동영상은 16:9 와이드인 경우) 검정색 막대가 플레이어에 적용됩니다. |
모든 동영상 |
playsinline |
true , false 또는 1,0 |
true |
동영상이 자동으로 전체 화면 모드로 전환되는 대신 모바일 기기에서 인라인으로 재생됩니다. 인라인 재생은 모든 동영상에서 기본적으로 활성화되어 있습니다. |
모든 동영상 |
muted |
true , false 또는 1,0 |
false |
로드 시 동영상을 음소거하도록 설정합니다. 시청자가 플레이어에서 볼륨 기본 설정을 조정할 수도 있습니다. Chrome이나 Safari 등 특정 브라우저에서 배경 동영상을 음소거 해제하거나 자동 재생 제한을 조정하는 데 사용할 수 있습니다. |
모든 동영상 |
dnt |
true , false 또는 1,0 |
false |
플레이어에서 버그를 확인하고 성능을 모니터링하기 위해 모든 재생 세션을 추적합니다. 이 매개변수를 true로 설정하면 플레이어가 재생 세션 데이터를 추적하지 못합니다. (브라우저에서 추적하지 않음헤더를 활성화했을 때와 동일한 효과를 가집니다) |
모든 동영상 |
#t |
분 및/또는 초 단위로 표시되는 시간(예: #t=1m2s) |
동영상 시작 |
예정된 특정 시점에 재생을 시작하는 데 사용합니다. 여기에서 자세히 알아보세요. 참고: 이 매개변수는 다른 매개변수처럼 접두사가 붙은 물음표를 요구하지 않습니다. |
모든 동영상 |
여러 개의 임베딩 매개변수 사용
같은 임베딩 코드에 여러 개의 매개변수를 추가하는 경우, 앰퍼샌드 (&)로 각각을 구분해야 합니다. 예를 들어:
<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에서 플레이어 기본 설정(예: 자동 재생)을 직접 조정할 수 있습니다.