通过

Playlists 和 PlaylistCollection 对象

  • 项目

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

PlaylistCollection 对象使你能够访问库中的播放列表，并具有从图元文件创建新的空播放列表和新播放列表的方法。

使用现有播放列表

PlaylistCollection。getAll 和 PlaylistCollection。getByName 方法分别返回一个 PlaylistArray 对象，该对象可以包含多个播放列表。

PlaylistCollection。getAll 方法返回库中的所有现有播放列表。 例如，可以调用此方法，然后检索 PlaylistArray 对象中的播放列表，以确定给定的播放列表名称是否已使用，或者向用户显示所有播放列表。 播放列表属性中的示例代码使用 getAll 方法。

PlaylistCollection。getByName 方法返回具有给定名称的所有播放列表。 可以使用此方法单独处理其中每个播放列表。

还可以使用 getByName 方法按名称检索唯一的播放列表。 在这种情况下， PlaylistArray 对象只有一个元素。 以下 C# 示例演示了此方法。

IWMPPlaylistArray PlayListArray;
IWMPPlaylist Playlist;
// Store the playlist named "BluesTest" in the array
PlayListArray = Player.playlistCollection.getByName("BluesTest");
// Retrieve the first playlist in the collection.
Playlist = PlaylistArray.Item(0);

使用新播放列表

可以使用 PlaylistCollection。newPlaylist 方法，用于创建新的空播放列表。 方法返回对新 Playlist 对象的引用。 然后，可以调用 播放列表。appendItem 方法，用于将媒体项添加到播放列表。

还可以基于播放列表图元文件创建新的播放列表。 首先，将播放列表的名称和图元文件的路径传递给 Player。newPlaylist 方法。 该方法返回对新 Playlist 对象的引用。 然后，将新的 Playlist 对象传递给 PlaylistCollection。importPlaylist 方法，用于将其添加到库。

请注意 PlaylistCollection 之间的差异。newPlaylist 方法和 Player。newPlaylist 方法。 PlaylistCollection 方法创建一个新的空播放列表，并将其添加到库中。 Player 方法创建一个新的填充的 Playlist 对象，但不将其添加到库中。

在本主题中， Player 对象按以下方式定义：

AxWMPLib.AxWindowsMediaPlayer Player;
using WMPLib;

以下 C# 示例演示如何从图元文件导入播放列表。 strPListName 参数指定新播放列表的名称。 strMetaFileName 指定从中导入播放列表的图元文件的名称。

private IWMPPlaylist importPlaylist(string strPlaylistName, string strMetaFileName)
{
    IWMPPlaylist  NewPlaylist;
    IWMPPlaylist  ImportPlaylist;

    NewPlaylist = Player.newPlaylist(strPlaylistName, strMetaFileName);
    ImportPlaylist = Player.playlistCollection.importPlaylist(NewPlaylist);

    return ImportPlaylist;
}

管理播放列表

Player.newPlaylist

Playlist.appendItem

PlaylistArray 对象

PlaylistCollection 对象

播放列表和媒体项