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 物件中的播放清單，以判斷指定的播放清單名稱是否已使用，或向使用者顯示所有播放清單。 Playlist 屬性中的範例程式碼會使用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 方法可將媒體專案新增至播放清單。

您也可以根據播放清單中繼檔建立新的播放清單。 首先，將播放清單的名稱和中繼檔的路徑傳遞至 播放機。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 物件

播放清單和媒體專案