MediaCollection.getByAttribute 메서드

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

getByAttribute 메서드는 지정된 특성에 대해 지정된 값을 포함하는 미디어 항목의 재생 목록을 검색합니다.

구문

retVal = MediaCollection.getByAttribute(
  attribute,
  value
)

매개 변수

특성 [in]

검색할 특성의 이름을 나타내는 문자열입니다. Windows 미디어 플레이어 지원하는 특성에 대한 자세한 내용은 Windows 미디어 플레이어 특성 참조를 참조하세요.

value [in]

특성에 있어야 하는 값을 나타내는 문자열입니다.

반환 값

이 메서드는 Playlist 개체를 반환합니다.

설명

이 메서드를 사용하여 데이터베이스의 특성 값과 일치하는 미디어 항목에 대한 일반 쿼리를 만들 수 있습니다. 이는 사용자 정의 특성의 경우에 유용합니다. 특성이 없으면 오류가 발생합니다.

이 메서드를 사용하여 특정 형식의 모든 미디어 항목을 검색할 수 있습니다. 특성 이름 "MediaType"과 다음 값 중 하나를 사용합니다.

값	설명
오디오	음악 및 기타 오디오 전용 항목입니다.
재생	미디어 개체로 표시되는 재생 목록입니다.
radio	라디오 방송국 항목. Windows 미디어 플레이어 10에서 사용되지 않습니다.
비디오	비디오 항목.
사진	사진 항목. Windows 미디어 플레이어 10이 필요합니다.
other	스트리밍 미디어에 대한 ASF 파일 또는 URL과 같은 기타 항목입니다.

이 메서드를 사용하려면 라이브러리에 대한 읽기 권한이 필요합니다. 자세한 내용은 라이브러리 액세스를 참조하세요.

예제

다음 JScript 예제에서는 MediaCollection을 사용합니다. getByAttribute - Triode 48이라는 아티스트가 라이브러리의 모든 콘텐츠를 재생합니다. Player 개체는 ID = "Player"로 만들어졌습니다.

// Get a playlist object filled with media items by a 
// particular artist.
var pl = Player.mediaCollection.getByAttribute("Artist", "Triode 48");

// Make the new playlist the current one.
Player.currentPlaylist = pl;

// Start Windows Media Player.
Player.controls.play();

요구 사항

요구 사항	값
버전	Windows 미디어 플레이어 버전 7.0 이상.
DLL	Wmp.dll

추가 정보

MediaCollection 개체

재생 목록 개체

Settings.mediaAccessRights

Settings.requestMediaAccessRights