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

true, false

또는

1,0

true, false

또는

1,0

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

true, false

또는

1,0

Vimeo 플레이어는 한 번에 하나의 동영상만 재생합니다. 동일한 페이지에 여러 개의 동영상을 표시하려면 각 동영상에 특정 매개변수를 추가해야 합니다.

⚠️ 참고: 자동 일시 중지가 작동하려면 브라우저에서 쿠키를 활성화해야 합니다.

true, false

또는

1,0

true, false

또는

1,0

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

1. 모든 플레이어 컨트롤(재생/일시 정지 포함) 비활성화
2. 동영상을 반복 재생으로 설정
3. 동영상을 자동 재생으로 설정
4. 동영상의 오디오 음소거

반복 또는 자동 재생을 방지하려면 controls=0 매개변수를 사용합니다. 

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

true, false

또는

1,0

true, false

또는

1,0

true, false

또는

1,0

true, false

또는

1,0

true, false

또는

1,0

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

⚠️참고: Chromecast는 iOS에서 지원되지 않습니다.

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

(예: 색상=000000,00adef,

ffffff,000000)

플레이어의 색상을 지정합니다.

색상은 동영상의 임베드 설정에 의해 재정의될 수 있습니다.

true, false

또는

1,0

true, false

또는

1,0

이 매개변수를 'true'로 설정하면 플레이어가 세션 데이터 및 분석을 수집하지 못하도록 차단되며, 이는 브라우저에서 추적 금지 기능을 활성화하는 것과 유사합니다.

⚠️ 참고: DNT가 활성화되어 있어도 일부 필수 쿠키는 여전히 활성화된 상태로 남아 있습니다. 이 목록은 Vimeo 플레이어 쿠키에서 확인할 수 있습니다.

true, false

또는

1,0

적응형 스트리밍이 시작되기 전에 잠시 표시되는 초기 동영상 화질.

더 빠른 로딩이나 더 나은 선명도를 위해 조정할 수 있습니다. 

낮은 화질(예: 360p)에서는 더 빠르게 로드되며, 높은 화질(예: 1080p 또는 4K)에서는 더 나은 해상도를 즉시 제공합니다.

true, false

또는

1,0

true, false

또는

1,0

true, false

또는

1,0

끝에 도달하면 무한으로 동영상을 다시 재생합니다.

💡팁: 반복 재생 옵션은 임베드 설정 페이지에서 동영상의 종료 화면으로 선택할 수도 있습니다. 자세한 내용은 종료 화면 정보에서 확인하세요.

동영상 재생 중 플레이어가 자동으로 선택하는 최고 화질. 플레이어는 이 값을 넘지 않는 범위 내에서 가장 좋은 화질을 선택합니다. 

이를 설정하면 대역폭 사용량을 줄이는 데 도움이 될 수 있습니다. 

동영상 플레이어의 화질 메뉴에서 360p, 720p, 1080p, 2K, 4K를 포함한 원하는 값을 선택할 수 있습니다.

동영상 재생 중 플레이어가 자동으로 선택하는 최저 화질. 플레이어는 이 임계값 아래로 떨어지지 않는 범위 내에서 최적의 화질을 선택합니다. 

이 매개변수 설정은 대역폭 제약을 고려하면서 뷰가 고해상도 동영상을 제공받을 수 있도록 보장합니다. 

플레이어에서 사용 가능한 화질 옵션(360p, 720p, 1080p, 2K, 4K 포함)을 선택할 수 있습니다.

true, false

또는

1,0

로드 시 동영상을 음소거하도록 설정합니다. 뷰어가 플레이어에서 볼륨 기본 설정을 조정할 수도 있습니다.

Chrome이나 Safari 등 특정 브라우저에서 배경 동영상을 음소거 해제하거나 자동 재생 제한을 조정하는 데 사용할 수 있습니다.

true, false

또는

1,0

true, false

또는

1,0

true, false

또는

1,0

플레이어의 재생 전 로딩 동작은 HTMLMediaElement 인터페이스의 기본 사전 로드 속성과 일치하며, 몇 가지 추가 옵션이 있습니다.

• 동영상의 메타데이터만 즉시 불러오려면 'metadata'를 사용합니다.
• 사용자가 플레이어 위로 마우스를 올려놓을 때 메타데이터를 로드하려면 'metadata_on_hover'를 사용합니다.
• 메타데이터와 동영상의 처음 몇 초를 즉시 로드하려면 'auto'를 사용합니다.
• 사용자가 마우스를 올려놓을 때만 메타데이터와 초기 동영상 세그먼트를 로드하려면 'auto_on_hover'를 사용합니다.
• 재생이 시작될 때까지 데이터를 로드하지 않도록 하려면 'none'을 사용합니다.

더 많은 데이터를 미리 로드하면 동영상이 더 빨리 시작됩니다. 따라서, 'auto' 및 'auto_on_hover'를 사용하면 동영상이 더 빨리 시작하지만 사용자가 동영상을 재생하든 안 하든 동영상 세그먼트가 로드되기 때문에 대역폭이 더 많이 필요합니다. Vimeo의 대역폭 제한에 대한 자세한 내용은 Vimeo의 대역폭 제한을 참조하세요.

true, false

또는

1,0

기본적으로 Vimeo 플레이어는 '자동' 모드로 설정되어 있습니다. 이는 즉, 뷰어의 대역폭과 재생 환경의 여러 요소를 바탕으로 가능한 최고 화질의 동영상을 선택합니다.

화질에서는 임베드된 동영상의 기본 재생 해상도를 지정할 수 있습니다. 사용할 수 없는 화질을 선택하면 매개변수가 무시되고 임베드 기본값이 '자동'으로 설정됩니다.

💡팁: 더 높은 화질 설정(예: 4K)을 선택하면 뷰어에게 과도한 버퍼링과 재생 끊김 현상이 발생할 수 있습니다.

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

업로드된 동영상 및 보관된 이벤트에 사용할 수 있습니다. 라이브 이벤트를 지원하지 않습니다.

true, false

또는

1,0

true, false

또는

1,0

true, false

또는

1,0

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

💡팁: 이 매개변수는 다른 매개변수와 달리 접두사 물음표가 필요하지 않습니다.

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

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

사용 가능한 경우 플레이어에 기본적으로 지정된 참조/자막 트랙 표시. 
 

동영상에 아직 업로드되지 않은 언어 설정을 선택하면 텍스트 트랙 설정이 무시되고, 임베드된 동영상이 기본적으로 캡션이나 자막이 꺼진 상태로 로드될 수 있습니다.

캡션 또는 자막이 있는 모든 동영상

(참고: 캡션과 자막은 동영상 소유자가 업로드해야 합니다. 캡션과 자막에서 자세히 알아보세요.)

true, false

또는

1,0

true, false

또는

1,0

색상이 설정이나 매개변수를 통해 지정되지 않은 경우, 투명 설정이 활성화됩니다. 

일반적으로 Vimeo 플레이어의 아이프레임 배경은 기본적으로 투명합니다. 비활성화하면 배경이 검은색으로 변경됩니다. 아이프레임의 높이와 너비가 동영상의 원본 화면 비율과 일치하지 않으면(예: 원본 동영상이 16:9인데 아이프레임을 4:3으로 설정한 경우) 플레이어에 검은색 막대가 표시됩니다.

true, false

또는

1,0

true, false

또는

1,0

true, false

또는

1,0

true, false

또는

1,0

true, false

또는

1,0