Metode MediaCollection.getByAttribute

[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 getByAttribute mengambil daftar putar item media yang berisi nilai tertentu untuk atribut tertentu.

Sintaks

retVal = MediaCollection.getByAttribute(
  attribute,
  value
)

Parameter

atribut [in]

String yang menunjukkan nama atribut untuk dicari. Untuk informasi tentang atribut yang didukung oleh Pemutar Media Windows, lihat Referensi Atribut Pemutar Media Windows.

value [in]

String yang menunjukkan nilai yang harus dimiliki atribut.

Mengembalikan nilai

Metode ini mengembalikan objek Playlist .

Keterangan

Metode ini dapat digunakan untuk membuat kueri umum untuk item media yang cocok dengan nilai untuk atribut dalam database. Ini berguna dalam kasus atribut yang ditentukan pengguna. Jika atribut tidak ada, kesalahan akan dihasilkan.

Anda dapat menggunakan metode ini untuk mengambil semua item media dari jenis tertentu. Gunakan nama atribut "MediaType" dan salah satu nilai berikut:

Nilai Deskripsi
Audio Musik dan item audio saja lainnya.
Playlist Daftar putar direpresentasikan sebagai objek Media .
radio Item stasiun radio. Tidak digunakan oleh Pemutar Media Windows 10.
Video Item video.
Foto Item foto. Membutuhkan Pemutar Media Windows 10.
lainnya Item lain, seperti file ASF atau URL ke media streaming.

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

Contoh

Contoh JScript berikut menggunakan MediaCollection. getByAttribute untuk memutar semua konten dari pustaka oleh seniman bernama Triode 48. Objek Pemutar dibuat dengan ID = "Pemutar".

// Get a playlist object filled with media items by a 
// particular artist.
var pl = Player.mediaCollection.getByAttribute("Artist", "Triode 48");

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

// Start Windows Media Player.
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