VIDEO 요소

  • 아티클

[이 페이지와 연결된 기능인 Windows 미디어 플레이어 SDK는 레거시 기능입니다. MediaPlayer로 대체되었습니다. MediaPlayer는 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 Windows 미디어 플레이어 SDK 대신 MediaPlayer를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

VIDEO 요소는 다음 특성 및 이벤트를 사용하여 스킨의 비디오 창을 조작하는 방법을 제공합니다. 편의를 위해 미리 정의된 VIDEO 요소도 제공됩니다.

VIDEO 요소는 다음 특성을 지원합니다.

attribute 설명
Backgroundcolor 비디오 컨트롤의 배경색을 지정하거나 검색합니다.
cursor 마우스가 비디오의 클릭 가능한 영역 위에 있을 때 사용되는 커서 값을 지정하거나 검색합니다.
fullScreen 비디오가 전체 화면 모드로 표시되는지 여부를 나타내는 값을 지정하거나 검색합니다. 런타임에만 설정할 수 있습니다.
maintainAspectRatio 컨트롤에 대해 정의된 너비와 높이에 맞추려고 할 때 비디오가 가로 세로 비율을 유지할지 여부를 나타내는 값을 지정하거나 검색합니다.
shrinkToFit 비디오가 비디오 컨트롤에 대해 정의된 너비 및 높이로 축소되는지 여부를 나타내는 값을 지정하거나 검색합니다.
stretchToFit 비디오가 비디오 컨트롤에 대해 정의된 너비와 높이로 확장되는지 여부를 나타내는 값을 지정하거나 검색합니다.
툴팁 비디오 창의 도구 설명 텍스트를 지정하거나 검색합니다.
창 없는 비디오 컨트롤이 창이 없거나 창이 없는지 여부를 나타내는 값을 지정하거나 검색합니다. 즉, 컨트롤의 전체 사각형이 항상 표시되거나 잘릴 수 있는지 여부입니다. 디자인 타임에만 설정할 수 있습니다.
확대 / 축소 비디오 크기를 조정할 백분율을 지정합니다.

 

VIDEO 요소는 다음 이벤트 처리기를 구현할 수 있습니다.

이벤트 처리기 설명
onvideoend 비디오가 렌더링을 중지하고 언로드될 때 발생하는 이벤트를 처리합니다.
onvideostart 비디오가 로드되고 렌더링을 시작할 때 발생하는 이벤트를 처리합니다.

 

VIDEO 요소는 앰비언트 특성을 지원하며 설명된 경우를 제외하고 앰비언트 이벤트 처리기를 구현할 수 있습니다. 자세한 내용은 앰비언트 특성 및 앰비언트 이벤트 처리기를 참조하세요.

미리 정의된 비디오 요소는 기본적으로 지정된 다양한 공통 특성 설정이 있는 일반 VIDEO 요소입니다. 다음과 같은 미리 정의된 비디오 요소를 사용할 수 있습니다.

미리 정의된 비디오 설명
WMPVIDEO 크기가 조정될 때 비디오를 늘이는 VIDEO 요소입니다.

 

스킨 프로그래밍 참조