MediaCollection.getByAlbum 메서드

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

GetByAlbum 메서드는 지정된 앨범의 미디어 항목이 포함된 재생 목록을 검색합니다.

구문

retVal = MediaCollection.getByAlbum(
  album
)

매개 변수

앨범 [in]

앨범 이름을 포함하는 문자열입니다.

반환 값

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

설명

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

예제

다음 예제에서는 MediaCollection을 사용합니다. getByAlbum - 미디어 항목의 재생 목록을 검색합니다. 재생 목록에는 GetAlbum이라는 HTML TEXT 입력 요소에서 사용자가 지정한 앨범이 포함된 항목이 포함됩니다. Player 개체는 ID = "Player"로 만들어졌습니다.

<!-- Use an HTML BUTTON element to create the playlist and 
then play the digital media items. -->
<INPUT TYPE = "BUTTON"
       NAME = "PlayAlbum" 
       ID = "PlayAlbum"  
       VALUE = "Play Album"

onClick = "
    /* Retrieve the album title text from the user. */
    var album = GetAlbum.value;

    /* Create the playlist using getByAlbum. */
    var pl = Player.mediaCollection.getByAlbum(album);

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

    /* Play the media in the new playlist. */
    Player.controls.play();
">

요구 사항

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

추가 정보

MediaCollection 개체

재생 목록 개체

Settings.mediaAccessRights

Settings.requestMediaAccessRights