이 페이지에서는 YouTube Player API의 함수를 보여줍니다. 내장 플레이어에는 200x200픽셀 이상의 표시 영역이 있어야 합니다. 플레이어에 컨트롤이 표시되는 경우에는 표시 영역이 최소 크기 미만으로 축소되지 않고 컨트롤이 완전히 표시될 만큼 커야 합니다. 16:9 플레이어의 경우 가로 480픽셀, 세로 270픽셀 이상으로 지정하는 것이 좋습니다.
IFrame 삽입 코드

콘텐츠 플레이어에서 콘텐츠를 로드하거나 신호를 주도록 선택할 수 있습니다. 콘텐츠를 로드하는 옵션을 선택한 다음 플레이어를 업데이트하면 플레이어에서 이미 재생 중인 동영상이 있는 경우 이 동영상 대신 지정한 콘텐츠가 재생됩니다.

콘텐츠에 신호를 주는 옵션을 선택하고 플레이어를 업데이트하면 플레이어에 동영상이 로드되지만 재생되지는 않습니다. 동영상을 재생하려면 플레이어 컨트롤 섹션의 재생 링크 또는 동영상 플레이어 자체를 클릭해야 합니다.

선택한 옵션에 따라 이 페이지에서 다음 API 함수 중 하나를 호출합니다.
  • loadVideoById
  • loadVideoByUrl
  • loadPlaylist
  • cueVideoById
  • cueVideoByUrl
  • cuePlaylist
 
 
컨트롤 이 섹션의 컨트롤을 사용하여 동영상을 재생하거나 일시중지하거나 중지할 수 있습니다.

동영상의 특정 지점을 탐색하려면 탐색 필드에 숫자를 입력합니다. 이 숫자는 재생을 시작해야 하는 시간 오프셋을 동영상 시작 부분으로부터 초 단위로 지정합니다.
재생 | 일시중지 | 중지
   
볼륨 음소거 및 음소거 해제 컨트롤은 볼륨을 끄거나 켭니다. 통계 섹션의 볼륨(켜짐/꺼짐) 필드는 플레이어가 음소거 상태인지 여부를 나타냅니다.

볼륨 설정 필드에 0에서 100 사이의 숫자를 입력하여 플레이어의 볼륨을 조절할 수 있습니다. 볼륨을 업데이트하려면 입력 상자의 바깥쪽을 클릭하거나 탭하세요.
음소거 | 음소거 해제 | 설정:   (0-100) [ 현재 볼륨 크기:  --]
품질 setPlaybackQuality() 함수를 호출하여 재생 중인 동영상의 품질을 변경하려면 이 풀다운 메뉴를 사용하세요. 품질을 변경하면 동영상이 일시중지되었다가 시작 부분부터 다시 재생되기 시작합니다.

통계 섹션의 사용 가능한 수준 필드에는 이 동영상에 사용할 수 있는 품질 수준이 나와 있습니다.

사용할 수 없는 품질 수준을 선택할 경우 YouTube에서는 사용할 수 있는 가장 적절한 품질 수준을 선택합니다. 예를 들어 품질을 작게로 선택했지만 지원되는 수준이 중간 및 크게인 경우 YouTube에서는 품질 수준을 중간으로 설정합니다.
속도 재생 속도는 동영상이 재생되고 있는 속도를 식별합니다. getAvailablePlaybackRates() 함수는 현재 동영상에서 사용할 수 있는 재생 속도의 모음을 반환합니다. 이 데모에서 사용할 수 있는 재생 속도는 통계 섹션에 나와 있습니다.

값이 1인 경우 동영상이 정상 속도로 재생 중임을 나타냅니다.
   
크기 이 섹션에서는 setSize(width, height) 함수로 플레이어의 크기를 수정할 수 있습니다. 일반적으로 이 함수는 ActionScript 애플리케이션에서만 유용합니다. JavaScript 애플리케이션에서는 동영상 플레이어를 포함한 개체가 크기를 조절한 플레이어보다 크거나 작은 경우에도 크기를 조절한 플레이어가 계속 이 개체에 삽입됩니다.
 x 405   
기록 플레이어에서 동영상을 재생할 준비가 되면 이 페이지에서 getVideoUrl() 및 getEmbedCode() 함수를 호출합니다. 이러한 함수는 동영상을 로드하거나 신호를 주면 다시 호출됩니다.

동영상이 10초 이상 재생된 후 getVideoUrl()을 호출하면 URL에 플레이어에서 동영상 재생을 시작해야 하는 시간 오프셋을 지정하는 매개변수가 포함됩니다. 		(삭제)
오류
아직 없음.

이벤트 및 함수 호출
아직 없음.

플레이어 매개변수
  • 선택한 체크박스 = 매개변수 값 1
  • 선택하지 않은 체크박스 = 매개변수 값 0
  • 선택한 옵션으로 플레이어를 삽입하려면 Iframe 삽입 코드를 사용하세요.

매개변수 값
autoplay  1 - 플레이어가 로드되면 자동으로 동영상 재생이 시작됩니다.

0(기본값) - 플레이어가 로드되면 동영상이 자동으로 재생되지 않습니다.
cc_load_policy  1 - 사용자가 자막을 끈 경우에도 자막이 기본적으로 표시됩니다. 기본 동작은 사용자의 환경설정을 기준으로 합니다.
color 이 매개변수는 플레이어의 동영상 진행률 표시줄에서 시청자가 이미 시청한 부분을 표시하기 위해 사용하는 색상을 지정합니다. 기본값은 빨간색입니다.
controls  1(기본값) - 동영상 플레이어에서 플레이어 컨트롤을 표시합니다.

0 - 동영상 플레이어에서 플레이어 컨트롤을 표시하지 않습니다.
disablekb  1 - 플레이어 키보드 컨트롤을 사용 중지합니다.

0(기본값) - 플레이어 키보드 컨트롤을 사용합니다. 키보드 컨트롤은 다음과 같습니다.
  • 스페이스바: 재생/일시중지
  • 왼쪽 화살표 키: 현재 동영상에서 몇 초 전으로 건너뛰기
  • 오른쪽 화살표 키: 현재 동영상에서 몇 초 후로 건너뛰기
  • 위쪽 화살표 키: 볼륨 높이기
  • 아래쪽 화살표: 볼륨 낮추기
enablejsapi  1 - IFrame Player API로 플레이어를 제어하도록 설정합니다.

0(기본값) - API를 사용하지 않습니다.
end  동영상 재생을 중지해야 하는 시간 오프셋입니다. 값은 플레이어에서 재생이 중지되는 시간(초)을 동영상에 지정하는 양의 정수입니다.
fs  1(기본값) - 플레이어에 전체화면 플레이어로 시청하는 버튼이 표시됩니다.

0 - 플레이어에 전체화면 버튼이 표시되지 않습니다.
hl 플레이어의 인터페이스 언어를 설정합니다. 매개변수 값은 ISO 639-1 두 자리 언어 코드(예: fr) 또는 완전하게 지정된 언어(예: fr-ca)입니다. IETF 언어 태그(BCP 47)와 같은 다른 언어 입력 코드도 올바르게 처리될 수 있습니다.

인터페이스 언어는 플레이어의 툴팁에 사용되며 기본 자막 트랙에도 영향을 줍니다.
iv_load_policy 1(기본값) - 동영상 특수효과를 표시합니다. 3 - 동영상 특수효과를 표시하지 않습니다.
list  이 매개변수는 list 매개변수와 함께 플레이어에 로드되는 콘텐츠를 식별합니다.
  • 재생목록 - list 매개변수는 YouTube 재생목록 ID를 지정합니다. 매개변수 값은 PL로 시작해야 합니다.
  • 검색 - list 매개변수는 재생할 콘텐츠를 선택하는 데 사용된 검색어를 지정합니다.
  • 사용자 업로드 - list 매개변수는 업로드된 동영상이 로드된 YouTube 채널을 지정합니다.
listType 이 매개변수는 list 매개변수와 함께 플레이어에 로드되는 콘텐츠를 식별합니다.
  • 검색 - list 매개변수는 재생할 콘텐츠를 선택하는 데 사용된 검색어를 지정합니다.
  • 사용자 업로드 - list 매개변수는 업로드된 동영상이 로드된 YouTube 채널을 지정합니다.
  • 재생목록 - list 매개변수는 YouTube 재생목록 ID를 지정합니다. 매개변수 값은 PL로 시작해야 합니다.
loop  1 - 플레이어에서 동영상 1개를 로드한 경우 이 동영상을 반복해서 재생합니다. 플레이어에서 재생목록을 로드한 경우 전체 재생목록을 재생한 다음 첫 번째 동영상부터 다시 시작합니다.

0(기본값) - 동영상 또는 전체 재생목록을 연속해서 재생하지 않습니다.
modestbranding  1 - YouTube 로고가 컨트롤바에 표시되지 않게 합니다. YouTube 텍스트 라벨 또는 워터마크는 사용자가 플레이어 위에 마우스 포인터를 올려놓으면 표시됩니다.

0 - YouTube 로고가 컨트롤바에 표시됩니다.
playlist  연속해서 재생되는 동영상 ID의 쉼표로 구분된 목록입니다.
playsinline  1 - TRUE로 설정된 allowsInlineMediaPlayback 속성으로 UIWebViews의 인라인 재생을 만들게 합니다.

0(기본값) - 전체화면으로 재생되게 합니다. 기본값은 변경될 수 있다는 점에 유의하세요.
start  동영상 재생을 시작해야 하는 시간 오프셋입니다. 값은 플레이어에서 재생을 시작해야 하는 시간(초)을 동영상에 지정하는 양의 정수입니다. 플레이어는 지정한 시간 직전이거나 가장 가까운 키프레임을 찾습니다.
통계   이 섹션의 정보는 동영상 플레이어 및 재생 중인 동영상(또는 최근에 재생한 동영상)의 상태를 설명합니다. 다음 목록은 이 섹션의 각 필드와 관련된 API 함수를 보여줍니다.
  • 길이: getDuration()
  • 현재 시간: getCurrentTime()
  • 플레이어 상태: getPlayerState()
  • 로드된 동영상 비율: getVideoLoadedFraction()
  • 시작 바이트: getVideoStartBytes()
  • 품질 수준: getPlaybackQuality()
  • 사용 가능한 수준: getAvailableQualityLevels()
  • 볼륨(켜짐/꺼짐): isMuted()
  • 재생목록의 동영상 수: count(getPlaylist())
  • 현재 동영상의 위치: getPlaylistIndex()
  • 재생목록의 동영상: getPlaylist()
  • 로드된 바이트: getVideoBytesLoaded()(지원 중단됨)
  • 전체 바이트: getVideoBytesTotal()(지원 중단됨)
길이: --:--
현재 시간: --:--
플레이어 상태: --
시작 바이트: --
로드된 동영상 비율: --
볼륨(켜짐/꺼짐):
재생 속도: --
사용 가능한 속도:
지원 중단됨
로드된 바이트: --
전체 바이트: --