MediaCollection.getByGenre メソッド

  • [アーティクル]

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

getByGenre メソッドは、指定したジャンルのメディア項目のプレイリストを取得します。

構文

retVal = MediaCollection.getByGenre(
  genre
)

パラメーター

ジャンル [入力]

ジャンルの名前を含む文字列。

戻り値

このメソッドは Playlist オブジェクトを返します。

解説

このメソッドを使用するには、ライブラリへの読み取りアクセスが必要です。 詳細については、「 ライブラリ アクセス」を参照してください。

例

次の JScript の例では 、MediaCollection を使用します。メディアアイテムのプレイリストを取得する getByGenre 。 プレイリストには、GetGenre という名前の HTML TEXT 入力要素でユーザーによって指定されたジャンルの項目が含まれています。 Player オブジェクトは ID = "Player" で作成されました。

<!-- Use an HTML BUTTON element to create the playlist and play 
the media items. -->
<INPUT TYPE = "BUTTON"  
       NAME = "PlayGenre"  
       ID = "PlayGenre"  
       VALUE = "Play Genre"

onClick = "
    /* Retrieve the genre text from the user. */
    var genre = GetGenre.value;

    /* Create the playlist using getByGenre. */
    var pl = Player.mediaCollection.getByGenre(genre);

    /* Make the new playlist the current playlist. */
    Player.currentPlaylist = pl;

    /* Play the digital media item in the new playlist. */
    Player.controls.play();
">

必要条件

要件 値
Version
 バージョン 7.0 以降をWindows メディア プレーヤーします。
[DLL]
Wmp.dll

関連項目

MediaCollection オブジェクト

Playlist オブジェクト

Settings.mediaAccessRights

Settings.requestMediaAccessRights