플레이어 매개변수에 대하여

매개변수

지원되는 값

기본값

설명

지원되는 동영상

audiotrack

소문자 언어 코드를 입력하거나, 동영상을 기본 오디오 트랙으로 설정하려면 'main'을 입력하세요.

false

플레이어에서 기본적으로 주어진 오디오 트랙을 표시합니다(오디오 트랙 보류 가능).

여러 오디오 트랙이 업로드된 모든 동영상 

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

이 매개변수를 추가하면 다음 변화가 적용됩니다.

1. 플레이어의 모든 토글과 요소가 비활성화됩니다 (재생/일시중지 버튼 포함).
2. 동영상이 자동으로 반복 재생됩니다.
3. 동영상이 자동 재생되도록 설정됩니다.
4. 동영상이 무음으로 재생됩니다.

동영상이 반복되거나 자동 재생되지 않도록 하려면 아래 controls=0 매개변수를 확인하세요. 

이 매개변수를 설정해도 키보드 컨트롤은 비활성화되지 않습니다. 

동영상은 Starter, Standard, Advanced, Plus, Pro, Business, Premium 또는 Enterprise 계정에서 호스팅되어야 합니다.

byline

true, false

또는

1,0

사이트의 동영상
임베드 설정에서
지정한 값

동영상 만든이를 표시합니다. (창작가 표시)

모든 동영상

(단, 동영상 소유자가 허용하는 경우에만)

color

[hex code]

Vimeo blue-
00adef

동영상 컨트롤의 색상을 지정합니다.
색상은 동영상의 임베드 설정에 의해 재정의될 수 있습니다.

동영상은 Starter, Standard, Advanced, Plus, Pro, Business, Premium 또는 Enterprise 계정에서 호스팅되어야 합니다.

1-4 [16진수 코드] - 쉼표로 구분됩니다.

(예: 색상=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

이 매개변수는 크롬리스 경험을 위해 플레이어의 모든 요소 (플레이바, 공유 버튼 등)를 숨깁니다. 

⚠️경고:

이 매개변수를 사용하면 재생/일시 중지 버튼이 숨겨집니다. 시청자를 위해 재생을 시작하려면 자동 재생을 활성화하거나 키보드 컨트롤을 사용하거나 플레이어 SDK를 구현하여 재생을 시작하고 제어해야 합니다.

이 매개변수를 설정해도 키보드 컨트롤은 비활성화되지 않습니다. 

동영상은 Starter, Standard, Advanced, Plus, Pro, Business, Premium 또는 Enterprise 계정에서 호스팅되어야 합니다.

dnt

true, false

또는

1,0

false

이 매개 변수를 "true"로 설정하면 플레이어가 세션 데이터 및 분석을 추적하지 못하도록 차단됩니다. 

(브라우저에서 추적 안 함 설정을 활성화하는 것과 동일한 효과가 발생합니다.)

⚠️경고:

DNT가 활성화되면 특정 필수 쿠키가 설정된 상태로 유지됩니다. 해당되는 쿠키 목록은 여기에서 확인할 수 있습니다.

모든 동영상

초기 품질

240p, 360p, 540p, 720p, 1080p, 2k, 4k

auto

동영상은 Starter, Standard, Advanced, Plus, Pro, Business, Premium 또는 Enterprise 계정에서 호스팅되어야 합니다.

keyboard

true, false

또는

1, 0

true

모든 동영상

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 등 특정 브라우저에서 배경 동영상을 음소거 해제하거나 자동 재생 제한을 조정하는 데 사용할 수 있습니다.

모든 동영상

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 계정에서 호스팅되어야 합니다.

skipping_forward

사용자가 임베딩 가능 플레이어에서 앞으로 건너뛸 수 있는지 여부

동영상은 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)

동영상 시작
(0m)

특정 시점에 자동으로 재생을 시작하기 위해 사용합니다. 자세한 내용은 '특정 타임코드에서 재생 시작하기'를 참조하세요.

참고: 이 매개변수는 다른 매개변수처럼 접두사가 붙은 물음표를 요구하지 않습니다.

모든 동영상

texttrack

소문자 언어 코드 및 선택적인 텍스트 트랙의 로케일 및 유형

(예: 'en', 'en-US', 'en.captions', 'en.subtitles)

false 

플레이어에서 기본적으로 주어진 CC/자막 트랙을 표시합니다. (CC/자막 트랙 보류 가능) 

특정 동영상에 아직 업로드되지 않은 언어 환경 설정을 입력하면 텍스트 트랙 매개변수가 무시되고 임베드된 동영상은 기본값에 의해 비활성화된 폐쇄 자막(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

컨트롤 막대에 스크립트 버튼을 표시하고 스크립트 컨트롤을 활성화합니다.

텍스트 트랙이 포함된 모든 동영상.