Objek Pemutar

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

Objek Pemutar adalah objek akar untuk kontrol Pemutar Media Windows. Ini mendukung properti, metode, dan peristiwa yang tercantum dalam tabel berikut.

Objek Pemutar mendukung properti berikut. Properti yang ditandai dengan tanda bintang (*) tidak dapat diakses oleh kulit.

Properti	Deskripsi
cdromCollection	Mengambil objek CdromCollection .
closedCaption	Mengambil objek ClosedCaption .
Kontrol	Mengambil objek Kontrol .
currentMedia	Menentukan atau mengambil objek Media saat ini.
currentPlaylist	Menentukan atau mengambil objek Daftar-putar saat ini.
Dvd	Mengambil objek DVD .
enableContextMenu *	Menentukan atau mengambil nilai yang menunjukkan apakah akan mengaktifkan menu konteks, yang muncul saat tombol kanan mouse diklik.
Diaktifkan *	Menentukan atau mengambil nilai yang menunjukkan apakah kontrol Pemutar Media Windows diaktifkan.
kesalahan	Mengambil objek Kesalahan .
Fullscreen *	Menentukan atau mengambil nilai yang menunjukkan apakah konten video diputar kembali dalam mode layar penuh.
isOnline	Mengambil nilai yang menunjukkan apakah pengguna tersambung ke jaringan.
isRemote *	Mengambil nilai yang menunjukkan apakah kontrol Pemutar Media Windows berjalan dalam mode jarak jauh.
mediaCollection	Mengambil objek MediaCollection .
network	Mengambil objek Jaringan .
openState	Mengambil nilai yang menunjukkan status sumber konten.
playerApplication *	Mengambil objek PlayerApplication ketika kontrol Pemutar Media Windows jarak jauh sedang berjalan.
playlistCollection	Mengambil objek PlaylistCollection .
playState	Mengambil nilai yang menunjukkan status operasi Pemutar Media Windows.
settings	Mengambil objek Pengaturan .
status	Mengambil nilai yang menunjukkan status Pemutar Media Windows saat ini.
stretchToFit *	Menentukan atau mengambil nilai yang menunjukkan apakah video akan membentang agar pas dengan ukuran tampilan video kontrol Pemutar Media Windows.
uiMode *	Menentukan atau mengambil nilai yang menunjukkan kontrol mana yang ditampilkan di antarmuka pengguna saat Pemutar Media Windows disematkan di halaman web.
URL	Menentukan atau mengambil nama klip yang akan diputar.
versionInfo	Mengambil nilai String yang menentukan versi Pemutar Media Windows.
windowlessVideo *	Menentukan atau mengambil nilai yang menunjukkan apakah kontrol Pemutar Media Windows merender video dalam mode tanpa jendela.

 

* Tidak dapat diakses oleh kulit.

Objek Pemutar mendukung metode berikut.

Metode	Deskripsi
Dekat	Merilis sumber daya Pemutar Media Windows.
launchURL	Mengirim URL ke browser default pengguna untuk dirender.
newMedia	Membuat objek Media baru.
newPlaylist	Membuat objek Daftar Putar baru.
openPlayer	Membuka Pemutar Media Windows menggunakan URL yang ditentukan.

 

Objek Pemutar mendukung peristiwa berikut. Peristiwa yang ditandai dengan tanda bintang (*) tidak dapat diakses oleh kulit. Untuk informasi tentang menangani peristiwa mouse dan keyboard di kulit, lihat Peristiwa Eksternal.

Kejadian	Deskripsi
AudioLanguageChange	Terjadi ketika bahasa audio saat ini berubah.
Buffering	Terjadi ketika kontrol Pemutar Media Windows dimulai atau berakhir buffering.
CdromMediaChange	Terjadi ketika CD atau DVD dimasukkan ke dalam atau dikeluarkan dari drive CD atau DVD.
Klik *	Terjadi ketika pengguna mengklik tombol mouse.
CurrentItemChange	Terjadi ketika Kontrol. perubahan currentItem .
CurrentMediaItemAvailable	Terjadi ketika item metadata grafik dalam item media saat ini menjadi tersedia.
CurrentPlaylistChange	Terjadi ketika sesuatu berubah dalam daftar putar saat ini.
CurrentPlaylistItemAvailable	Terjadi ketika item daftar putar saat ini tersedia.
Putuskan sambungan	Disiapkan untuk penggunaan masa mendatang.
Perubahan Domain	Terjadi ketika domain DVD berubah.
Doubleclick *	Terjadi ketika pengguna mengklik dua kali tombol mouse.
DurationUnitChange	Disiapkan untuk penggunaan masa mendatang.
EndOfStream	Disiapkan untuk penggunaan masa mendatang.
Kesalahan	Terjadi ketika kontrol Pemutar Media Windows memiliki kondisi kesalahan.
Keydown *	Terjadi ketika tombol ditekan.
KeyPress *	Terjadi ketika tombol ditekan lalu dilepaskan.
Keyup *	Terjadi ketika kunci dilepaskan.
MarkerHit	Terjadi ketika penanda tercapai.
MediaChange	Terjadi ketika item media berubah.
MediaCollectionAttributeStringAdded	Terjadi ketika nilai atribut ditambahkan ke pustaka.
MediaCollectionAttributeStringChanged	Terjadi ketika nilai atribut di pustaka diubah.
MediaCollectionAttributeStringRemoved	Terjadi ketika nilai atribut dihapus dari pustaka.
MediaCollectionChange	Terjadi ketika pengumpulan media berubah.
MediaCollectionMediaAdded	Terjadi ketika item media ditambahkan ke pustaka lokal.
MediaCollectionMediaRemoved	Terjadi ketika item media dihapus dari pustaka lokal.
MediaError	Terjadi ketika objek Media memiliki kondisi kesalahan.
ModeChange	Terjadi ketika mode Pemutar Media Windows diubah.
Mousedown *	Terjadi ketika tombol mouse ditekan.
MouseMove *	Terjadi ketika penunjuk mouse dipindahkan.
MouseUp *	Terjadi ketika tombol mouse dilepaskan.
NewStream	Disiapkan untuk penggunaan masa mendatang.
OpenPlaylistSwitch	Terjadi ketika judul pada DVD mulai diputar.
OpenStateChange	Terjadi ketika kontrol Pemutar Media Windows mengubah status.
PlaylistChange	Terjadi ketika daftar putar berubah.
PlaylistCollectionChange	Terjadi ketika sesuatu berubah dalam koleksi daftar putar.
PlaylistCollectionPlaylistAdded	Terjadi ketika daftar putar ditambahkan ke koleksi daftar putar.
PlaylistCollectionPlaylistRemoved	Terjadi ketika daftar putar dihapus dari koleksi daftar putar.
PlaylistCollectionPlaylistSetAsDeleted	Disiapkan untuk penggunaan masa mendatang.
PlayStateChange	Terjadi ketika status pemutaran kontrol Pemutar Media Windows berubah.
PositionChange	Terjadi ketika posisi item media saat ini telah diubah.
ScriptCommand	Terjadi ketika perintah atau URL yang disinkronkan diterima.
StatusChange	Terjadi ketika properti status berubah nilai.
StringCollectionChange	Terjadi saat kumpulan string berubah.
Peringatan	Disiapkan untuk penggunaan masa mendatang.

 

* Tidak dapat diakses oleh kulit. Untuk informasi tentang menangani peristiwa mouse dan keyboard di kulit, lihat Penanganan Aktivitas Sekitar.

Ketika disematkan di halaman web, objek Pemutar dapat diakses dengan menggunakan nilai ID yang ditentukan dalam tag OBJECT. Dalam file definisi kulit, file tersebut diakses dengan menggunakan atribut global pemutar . Untuk tujuan ilustrasi, pemutar akan digunakan sebagai ID objek di bagian sintaks referensi.

Lihat juga

Referensi Model Objek untuk Pembuatan Skrip