Playlists と PlaylistCollection オブジェクト

  • [アーティクル]

[このページWindows メディア プレーヤー SDK に関連付けられている機能は、レガシ機能です。 MediaPlayer に置き換わりました。 MediaPlayer は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能な場合は SDK ではなく MediaPlayerWindows メディア プレーヤー使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]

PlaylistCollection オブジェクトを使用すると、ライブラリ内のプレイリストにアクセスでき、メタファイルから新しい空のプレイリストと新しいプレイリストを作成するためのメソッドがあります。

既存のプレイリストの操作

PlaylistCollection。getAll と PlaylistCollection。getByName メソッドは、それぞれ PlaylistArray オブジェクトを返します。このオブジェクトには複数のプレイリストを含めることができます。

PlaylistCollection。getAll メソッドは、ライブラリ内にあるすべての既存のプレイリストを返します。 たとえば、このメソッドを呼び出し、 PlaylistArray オブジェクト内のプレイリストを取得して、特定のプレイリスト名が既に使用されているかどうかを判断したり、すべてのプレイリストをユーザーに表示したりできます。 Playlist 属性のサンプル コードでは、getAll メソッドを使用します。

PlaylistCollection。getByName メソッドは、指定された名前を持つすべてのプレイリストを返します。 このメソッドを使用して、これらの各プレイリストを個別に処理できます。

getByName メソッドを使用して、名前で一意のプレイリストを取得することもできます。 その場合、 PlaylistArray オブジェクトに含まれる要素は 1 つだけです。 次の 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 オブジェクト

プレイリストとメディアアイテム