メディア アイテムの管理

  • [アーティクル]

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

Media オブジェクトは、1 つのメディア項目を表します。 これには、情報を取得してユーザーに表示したり、取得した値に基づいてさまざまなアクションを実行したりするために使用できるプロパティとメソッドがあります。

Media オブジェクトを使用する作業の多くは、属性と呼ばれるメディア項目のコンテンツに関するメタデータを含みます。 トピック 「Media Item Attributes」では、 属性値の読み取りと変更の方法について説明します。 このトピックに加えて、属性とその使用方法の詳細については、Microsoft Web サイトの Windows Media Metadata Usage Guidelines を参照してください。

Media オブジェクトには、項目の名前や期間など、一部の属性を直接取得するプロパティとメソッドがあります。 ビデオアイテムの場合は、画像の高さと幅を取得し、マーカーの名前またはインデックスに基づいてマーカー情報を取得できます。 特定のメディアアイテムが特定のプレイリストに含まれているかどうかを判断することもできます。

メディア オブジェクトの取得

プレーヤーを使用すると、現在のメディアアイテムにすばやくアクセスできます。currentMedia プロパティ。

このトピックでは、 Player オブジェクトを次の方法で定義しました。

AxWMPLib.AxWindowsMediaPlayer Player;
using WMPLib;

次の C# の例では、現在のアイテムを表す Media オブジェクトを取得します。

IWMPMedia media;
media = Player.currentMedia;

プレーヤーを使用して、デジタル メディア ファイルから新しいメディア アイテムを作成できます。newMedia メソッド。 メソッドに URL パスをデジタル メディア ファイルに渡すと、新しい Media オブジェクトへの参照が返されます。 メソッドは、新しいオブジェクトをライブラリに直接追加しません。 ただし、 オブジェクトをプレイリストに渡すことができます。appendItem メソッドまたは Playlist。insertItem メソッド。

次の C# の例では、Windows メディア プレーヤー SDK と共にインストールされているデジタル メディア サンプルのいずれかに基づいて Media オブジェクトを作成します。

IWMPMedia media;
media = Player.newMedia("C:\\WMSDK\\WMPSDK10\\samples\\media\\laure.wma");

注意

1 つの実際の円記号を表すには、2 つの円記号 (\) 文字を文字列に含める (または C#で @ 文字を使用する) 必要があります。 これは、C# が 1 つの円記号文字を使用してエスケープ シーケンスを定義するためです。

 

MediaCollection を使用して、デジタル メディア ファイルから新しいメディア アイテムを作成し、ライブラリに 1 つの手順で追加できます。add メソッド。 プレーヤーと同じです。newMedia メソッドでは、add メソッドはデジタル メディア ファイルへのパスを取得します。

次の C# の例では、いずれかの SDK サンプル ファイルに基づいて Media オブジェクトを作成し、そのオブジェクトをライブラリに追加します。

IWMPMedia media;
media = Player.mediaCollection.add("C:\\WMSDK\\WMPSDK10\\samples\\media\\laure.wma");

プレイリストを使用して、プレイリスト内のメディア項目を表す Media オブジェクトを取得できます。item メソッド。 次の C# の例では、現在のプレイリストから 6 番目のメディア項目を取得します。

IWMPMedia media;
media = Player.currentPlaylist.get_Item(5);

Controls.currentItem

プレイリストの管理

Media オブジェクト

MediaCollection.add

Player.currentMedia

Player.newMedia

Playlist.item

ライブラリの操作