Metode DownloadCollection.startDownload

[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.]

Catatan

Bagian ini menjelaskan fungsionalitas yang dirancang untuk digunakan oleh toko online. Penggunaan fungsionalitas ini di luar konteks toko online tidak didukung.

Metode startDownload mengantre unduhan.

Sintaks

retVal = DownloadCollection.startDownload(
  sourceURL,
  type
)

Parameter

sourceURL [in]

String yang menentukan URL unduhan.

type [in]

String yang menentukan jenis unduhan. Berisi salah satu nilai berikut.

Nilai	Deskripsi
latar belakang	(Windows XP dan yang lebih baru.) Unduhan terjadi sebagai proses latar belakang saat waktu prosesor tersedia. Status unduhan tetap ada bahkan ketika Pemutar Media Windows atau Windows XP dimatikan.
real time	(Semua sistem operasi yang didukung.) Unduhan terjadi sekaligus. Tidak ada status unduhan yang bertahan di antara sesi.

Nilai kembali

Metode ini mengembalikan objek DownloadItem .

Keterangan

Saat unduhan baru dimulai, Download Manager menambahkannya sebagai item ke koleksi unduhan yang memulai pengunduhan.

Hanya format media digital berikut yang dapat diunduh:

• Format Sistem Tingkat Lanjut (ASF)
• MP3
• Windows Media Audio (WMA)
• Windows Media Video (WMV)

Parameter sourceURL tidak mendukung string yang dikodekan Unicode. Ini harus menunjuk ke konten yang valid. Pengalihan tidak didukung.

Saat menggunakan Windows XP, file audio secara otomatis ditempatkan ke subfolder Musik Saya yang sesuai berdasarkan nilai metadata tingkat file. File video ditempatkan ke dalam \My Music\download\random number\type, di mana angka acak adalah nilai acak yang dihasilkan oleh Pemutar Media Windows untuk setiap pengguna, dan jenisnya adalah "real time" atau "latar belakang", tergantung pada jenis unduhan.

Saat menggunakan seri Pemutar Media Windows 9 dengan Windows 98 dan Windows Millennium Edition (ME), file audio dan video ditempatkan ke dalamjenisangka\ \My Music\download\random, di mana angka acak adalah nilai acak yang dihasilkan oleh Pemutar untuk setiap pengguna, dan jenisnya adalah "real time" atau "latar belakang", tergantung pada jenis unduhan.

Perhatikan bahwa file dapat diganti namanya berdasarkan atribut metadata yang terkandung dalam file dan aturan yang ditentukan oleh pengguna dalam kotak dialog Opsi . File yang tidak berisi metadata, seperti Album atau Artis, dapat dipindahkan ke folder berlabel Artis Tak Dikenal atau Album Tidak Diketahui.

Persyaratan

Persyaratan	Nilai
Versi	Pemutar Media Windows Seri 9 atau yang lebih baru
DLL	Wmp.dll

Lihat juga

Objek DownloadCollection

Objek DownloadItem