PlaylistCollection.newPlaylist 메서드

  • 아티클

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

newPlaylist 메서드는 라이브러리에 새 재생 목록을 만듭니다.

구문

retVal = PlaylistCollection.newPlaylist(
  name
)

매개 변수

name [in]

만들 재생 목록의 이름을 포함하는 문자열입니다.

반환 값

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

설명

이 메서드는 라이브러리에 빈 재생 목록을 만듭니다. 재생 목록을 미디어 항목으로 채우려면 재생 목록을 사용합니다. appendItem 또는 Playlist. insertItem.

라이브러리에서 이름이 같은 여러 재생 목록이 허용됩니다. 이 메서드를 사용하여 중복 재생 목록 이름을 만들지 않도록 하려면 getByName 및 PlaylistArray를 사용합니다. count - 특정 이름의 재생 목록이 이미 있는지 여부를 확인합니다.

선행 및 후행 공백은 재생 목록 이름에 허용되지 않으며 이름 매개 변수에 지정된 값에서 자동으로 제거됩니다.

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

예제

다음 JScript 예제에서는 "ThreeList"라는 빈 재생 목록을 새로 만듭니다. Player 개체는 ID="Player"로 만들어졌습니다.

//Add a new empty playlist, named ThreeList, to the playlist collection.
var NewList = Player.playlistCollection.newPlaylist("ThreeList");

요구 사항

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

추가 정보

MediaCollection.add

Playlist.appendItem

Playlist.insertItem

PlaylistArray.count

PlaylistCollection 개체

PlaylistCollection.getByName

PlaylistCollection.importPlaylist

PlaylistCollection.remove

Settings.mediaAccessRights

Settings.requestMediaAccessRights