MediaCollection.getByAlbum メソッド

  • [アーティクル]

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

GetByAlbum メソッドは、指定されたアルバムからメディア項目を含むプレイリストを取得します。

構文

retVal = MediaCollection.getByAlbum(
  album
)

パラメーター

アルバム [入力]

アルバムの名前を含む文字列。

戻り値

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

解説

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

例

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

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

onClick = "
    /* Retrieve the album title text from the user. */
    var album = GetAlbum.value;

    /* Create the playlist using getByAlbum. */
    var pl = Player.mediaCollection.getByAlbum(album);

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

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

必要条件

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

関連項目

MediaCollection オブジェクト

Playlist オブジェクト

Settings.mediaAccessRights

Settings.requestMediaAccessRights