Metode Controls.playItem

[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 playItem memutar item media yang ditentukan.

Sintaks

Controls.playItem(
  theMediaItem
)

Parameter

theMediaItem [in]

Objek media yang akan diputar.

Mengembalikan nilai

Metode ini tidak mengembalikan nilai.

Keterangan

Item media akan dimuat dan diputar secara otomatis, terlepas dari nilai Pengaturan. properti autoStart . Untuk memuat item tanpa memutarnya secara otomatis, atur Pengaturan. mulai otomatis ke false dan tetapkan nilai ke Player. URL, setelah itu pemutaran dapat dipanggil untuk mulai memutar item.

Catatan

playItem hanya berfungsi dengan item di currentPlaylist. Memanggil playItem dengan referensi ke item media tersimpan tidak didukung.

Contoh

Contoh JScript berikut menggunakan playItem untuk memutar item media dari daftar putar saat ini. Item yang akan diputar dipilih berdasarkan posisinya dalam daftar putar. Objek Pemutar dibuat dengan ID = "Pemutar".

// Declare a variable to hold the position of the media item 
// in the current playlist. An arbitrary value is supplied here.
var index = 3

// Retrieve the media item at the fourth position in the current playlist.
var media = Player.currentPlaylist.item(index);

// Play the media item.
Player.controls.playItem(media);

Persyaratan

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

Lihat juga

Objek Kontrol

Daftar putar.item