Playlist 对象

[与此页面关联的功能（Windows 媒体播放器 SDK）是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 如果可能，Microsoft 强烈建议新代码使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

Playlist 对象提供了一种组织列表中的媒体项的方法，以便使用以下属性和方法轻松操作。

Playlist 对象支持以下属性。

属性	说明
attributeCount	检索与播放列表关联的属性数。
attributeName	检索索引指定的属性的名称。
计数	检索播放列表中的项数。
name	指定或检索播放列表的名称。

 

Playlist 对象支持以下方法。

方法	说明
appendItem	将媒体项添加到播放列表的末尾。
clear	保留供将来使用。
getItemInfo	检索播放列表属性的值。
insertItem	将媒体项插入到位于指定位置的播放列表中。
isIdentical	检索一个值，该值指示提供的 Playlist 对象是否与当前对象相同。
item	检索指定索引处的媒体项。
moveItem	更改项目在播放列表中的位置。
removeItem	从播放列表中删除指定的项。
setItemInfo	指定播放列表属性的值。

 

通过以下属性和方法访问 Playlist 对象。

对象	属性或方法
Cdrom	播放列表
MediaCollection	getAll、 getByAlbum、 getByAttribute、 getByAuthor、 getByGenre、 getByName
播放器	currentPlaylist、 newPlaylist
PlaylistArray	item
PlaylistCollection	newPlaylist

 

因为它是最常见的访问方式， 玩家。currentPlaylist 用于在参考语法部分进行说明。

另请参阅

脚本的对象模型参考