사이트에서 동영상의 임베딩 설정을 조정할 수 있을 뿐 아니라, 다양한 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에서는 자동 일시 중지 기능이 지원되지 않습니다. - 자동 일시 중지가 작동하려면 브라우저에서 쿠키를 활성화해야 합니다. |
모든 동영상 |
|
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진수 코드] - 쉼표로 구분됩니다. (예: 색상=000000,00adef, ffffff,000000) |
색상 1 - 기본: #000000 |
플레이어의 색상을 지정합니다. 색상은 동영상의 임베드 설정에 의해 재정의될 수 있습니다. |
동영상은 Starter, Standard, Advanced, Plus, Pro, Business, Premium 또는 Enterprise 계정에서 호스팅되어야 합니다. |
|
controls |
true , false 또는 1,0 |
true |
이 매개변수는 크롬리스 경험을 위해 플레이어의 모든 요소 (플레이바, 공유 버튼 등)를 숨깁니다.
⚠️경고: 이 매개변수를 사용하면 재생/일시 중지 버튼이 숨겨집니다. 시청자를 위해 재생을 시작하려면 자동 재생을 활성화하거나 키보드 컨트롤을 사용하거나 플레이어 SDK를 구현하여 재생을 시작하고 제어해야 합니다. 이 매개변수를 설정해도 키보드 컨트롤은 비활성화되지 않습니다. |
동영상은 Starter, Standard, Advanced, Plus, Pro, Business, Premium 또는 Enterprise 계정에서 호스팅되어야 합니다. |
|
dnt |
true, false 또는 1,0 |
false |
이 매개 변수를 "true"로 설정하면 플레이어가 세션 데이터 및 분석을 추적하지 못하도록 차단됩니다. (브라우저에서 추적 안 함 설정을 활성화하는 것과 동일한 효과가 발생합니다.) ⚠️경고: DNT가 활성화되면 특정 필수 쿠키가 설정된 상태로 유지됩니다. 해당되는 쿠키 목록은 여기에서 확인할 수 있습니다. |
모든 동영상 |
|
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 |
컨트롤 바에 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)로 기본값을 설정하면 시청자에게 과도한 버퍼링 및 끊김 현상이 발생할 수 있습니다. - 이 매개변수는 업로드된 동영상 및 임베드된 아카이브 이벤트에만 지원됩니다. 라이브 이벤트에는 지원되지 않습니다. |
동영상은 Starter, Standard, Advanced, Plus, Pro, Business, Premium 또는 Enterprise 계정에서 호스팅되어야 합니다. |
|
speed |
true , false 또는 1,0 |
false |
플레이어의 기본 설정 메뉴에서 속도 제어를 표시하고 재생 속도 API를 활성화합니다. (Vimeo 개발자: API에서 플레이어 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 |
컨트롤 막대에 스크립트 버튼을 표시하고 스크립트 컨트롤을 활성화합니다. |
텍스트 트랙이 포함된 모든 동영상. |