Metode MediaCollection.add

  • 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 tambah menambahkan item media baru atau daftar putar ke pustaka.

Sintaks

retVal = MediaCollection.add(
  path
)

Parameter

path [in]

String yang berisi jalur.

Mengembalikan nilai

Metode ini mengembalikan objek Media .

Keterangan

Metode ini memuat item media atau daftar putar yang ada ke pustaka, diberikan jalur ke file. Metode ini tidak memindahkan atau mengubah file. Metode ini gagal jika diberikan jalur lokal yang tidak valid, tetapi file media digital tidak diperiksa validitasnya sebelum ditambahkan ke pustaka.

Metode ini menerima file daftar putar statis dan otomatis. PlaylistCollection. metode importPlaylist juga dapat digunakan untuk menambahkan daftar putar statis ke pustaka.

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

Contoh

Contoh Microsoft JScript berikut menambahkan tiga objek media ke koleksi media Pemutar Media Windows. Objek Pemutar dibuat dengan ID="Player".

// Adding a media object using a website.
Player.mediaCollection.add("https://www.proseware.com/Media/Laure.wma");

// Adding a media object from a local network.
// You must add an escape sequence of a backslash for 
// every original backslash.
Player.mediaCollection.add("\\\\yourservername\\Public\\Jeanne.wma");

// Adding a media object from a file on a local drive.
// Be sure to add appropriate escape sequences.
Player.mediaCollection.add("C:\\WMSDK\\WMPSDK\\docs\\samples\\media\\house.wma");

Persyaratan

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

Lihat juga

Mengelola Daftar Putar

Objek Media

Objek MediaCollection

MediaCollection.remove

PlaylistCollection.importPlaylist

Settings.mediaAccessRights

Settings.requestMediaAccessRights