Metode MediaCollection.getByName

  • Artikel

[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 getByName mengambil daftar putar item media dengan nama yang ditentukan.

Sintaks

retVal = MediaCollection.getByName(
  name
)

Parameter

name [in]

String yang berisi nama.

Mengembalikan nilai

Metode ini mengembalikan objek Playlist .

Keterangan

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

Contoh

Contoh JScript berikut menggunakan MediaCollection. getByName untuk mengambil tiga item dari pustaka. Setiap item kemudian ditambahkan ke daftar putar saat ini. Objek Pemutar dibuat dengan ID="Pemutar".

// In each case, use the name exactly as it appears in the library.
// Windows Media Player does not include file name extensions or file paths
// in the name. Internet URLs include the entire path, but not the 
// file name extension.

// Get a playlist object that contains an Internet URL.
var One = Player.mediaCollection.getByName("https://www.proseware.com/Media/Laure");
 
// Get a playlist object that contains a file on a network server.
var Two = Player.mediaCollection.getByName("Jeanne");

// Get a playlist object that contains a file on a local drive.
var Three = Player.mediaCollection.getByName("house");

// Append each item to the current playlist. Since each playlist retrieved
// using getByName contains one digital media item, use Playlist.item with
// an index of zero to reference that item.
Player.currentPlaylist.appendItem(One.item(0));
Player.currentPlaylist.appendItem(Two.item(0));
Player.currentPlaylist.appendItem(Three.item(0));

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