MediaCollection.getByName 메서드

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

getByName 메서드는 지정된 이름의 미디어 항목 재생 목록을 검색합니다.

구문

retVal = MediaCollection.getByName(
  name
)

매개 변수

name [in]

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

반환 값

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

설명

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

예제

다음 JScript 예제에서는 MediaCollection을 사용합니다. getByName - 라이브러리에서 세 개의 항목을 검색합니다. 그런 다음 각 항목이 현재 재생 목록에 추가됩니다. Player 개체는 ID="Player"로 만들어졌습니다.

// In each case, use the name exactly as it appears in the library.
// Windows Media Player does not include file name extensions or file paths
// in the name. Internet URLs include the entire path, but not the 
// file name extension.

// Get a playlist object that contains an Internet URL.
var One = Player.mediaCollection.getByName("https://www.proseware.com/Media/Laure");
 
// Get a playlist object that contains a file on a network server.
var Two = Player.mediaCollection.getByName("Jeanne");

// Get a playlist object that contains a file on a local drive.
var Three = Player.mediaCollection.getByName("house");

// Append each item to the current playlist. Since each playlist retrieved
// using getByName contains one digital media item, use Playlist.item with
// an index of zero to reference that item.
Player.currentPlaylist.appendItem(One.item(0));
Player.currentPlaylist.appendItem(Two.item(0));
Player.currentPlaylist.appendItem(Three.item(0));

요구 사항

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

추가 정보

MediaCollection 개체

재생 목록 개체

Settings.mediaAccessRights

Settings.requestMediaAccessRights