Media 개체

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

Media 개체는 다음 속성과 메서드를 사용하여 미디어 항목의 속성을 지정하거나 검색하는 방법을 제공합니다.

Media 개체는 다음 속성을 지원합니다.

속성	설명
attributeCount	미디어 항목에 대해 쿼리 및/또는 설정할 수 있는 특성 수를 검색합니다.
duration	현재 미디어 항목의 기간(초)을 검색합니다.
durationString	HH:MM:SS 형식으로 현재 미디어 항목의 기간을 나타내는 String 값을 검색합니다.
error	미디어 항목에 오류 조건이 있는 경우 ErrorItem 개체를 검색합니다.
imageSourceHeight	현재 미디어 항목의 높이를 픽셀 단위로 검색합니다.
imageSourceWidth	현재 미디어 항목의 너비를 픽셀 단위로 검색합니다.
markerCount	미디어 항목의 표식 수를 검색합니다.
name	미디어 항목의 이름을 지정하거나 검색합니다.
sourceURL	미디어 항목의 URL을 검색합니다.

 

Media 개체는 다음 메서드를 지원합니다.

메서드	설명
getAttributeCountByType	지정된 특성 이름 및 언어와 연결된 특성 수를 검색합니다.
getAttributeName	지정된 인덱스에 해당하는 특성의 이름을 검색합니다.
getItemInfo	미디어 항목에 대해 지정된 특성의 값을 검색합니다.
getItemInfoByAtom	지정된 인덱스 번호를 사용하여 특성의 값을 검색합니다.
getItemInfoByType	지정된 특성 이름, 언어 및 인덱스에 해당하는 특성의 값을 검색합니다.
getMarkerName	지정된 인덱스에서 표식의 이름을 검색합니다.
getMarkerTime	지정된 인덱스에서 표식의 시간을 검색합니다.
isIdentical	제공된 개체가 현재 개체와 같은지 여부를 나타내는 값을 검색합니다.
isMemberOf	지정된 미디어 항목이 지정된 재생 목록의 멤버인지 여부를 나타내는 값을 검색합니다.
isReadOnlyItem	지정된 미디어 항목의 특성을 편집할 수 있는지 여부를 나타내는 값을 검색합니다.
setItemInfo	미디어 항목에 대해 지정된 특성의 값을 설정합니다.

 

Media 개체는 다음 속성 및 메서드를 통해 액세스됩니다.

개체	속성 또는 메서드
컨트롤	Currentitem
Player	currentMedia, newMedia
재생 목록	item

 

가장 일반적인 액세스 수단이므로 플레이어입니다. currentMedia 는 참조 구문 섹션의 설명을 위해 사용됩니다.

추가 정보

스크립팅에 대한 개체 모델 참조