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 |
|
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk