Metode MediaCollection.getByAlbum

[Fitur yang terkait dengan halaman ini, Pemutar Media Windows SDK, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer. MediaPlayer telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer alih-alih Pemutar Media Windows SDK, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Metode GetByAlbum mengambil daftar putar yang berisi item media dari album yang ditentukan.

Sintaks

retVal = MediaCollection.getByAlbum(
  album
)

Parameter

album [in]

String yang berisi nama album.

Mengembalikan nilai

Metode ini mengembalikan objek Daftar Putar .

Keterangan

Untuk menggunakan metode ini, diperlukan akses baca ke pustaka. Untuk informasi selengkapnya, lihat Akses Pustaka.

Contoh

Contoh berikut menggunakan MediaCollection. getByAlbum untuk mengambil daftar putar item media. Daftar putar berisi item dengan album yang ditentukan oleh pengguna dalam elemen input TEKS HTML bernama GetAlbum. Objek Pemutar dibuat dengan ID = "Pemutar".

<!-- 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();
">

Persyaratan

Persyaratan	Nilai
Versi	Pemutar Media Windows versi 7.0 atau yang lebih baru.
DLL	Wmp.dll

Lihat juga

Objek MediaCollection

Objek Daftar Putar

Settings.mediaAccessRights

Settings.requestMediaAccessRights