Elemen EVENT

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

Elemen EVENT mendefinisikan perilaku atau tindakan yang diambil oleh Pemutar Media Windows saat menerima perintah skrip berlabel peristiwa.

<EVENT   
   NAME = "text string"
   WHENDONE = "RESUME" | "NEXT" | "BREAK"
>
</EVENT>

Atribut

NAME (diperlukan)

Nama peristiwa.

WHENDONE (diperlukan)

Nilai yang menentukan apa yang Pemutar Media Windows lakukan setelah memutar konten yang dirujuk.

Nilai berikut dimungkinkan.

Nilai	Deskripsi
MELANJUTKAN	Entri saat ini (klip terganggu oleh peristiwa) dilanjutkan pemutaran. Jika konten disimpan, konten akan dilanjutkan pada titik yang sama di mana konten dihentikan; jika konten disiarkan, konten akan dilanjutkan pada posisi saat ini.
BERIKUTNYA	Elemen ENTRY berikutnya diputar seolah-olah peristiwa belum terjadi dan Pemutar Media Windows telah mencapai akhir klip saat ini.
BREAK	Jika entri saat ini berada dalam perulangan REPEAT , perulangan berakhir seolah-olah jumlah pengulangan telah selesai. Jika tidak, Pemutar Media Windows melompat ke akhir daftar putar seolah-olah entri akhir telah selesai seperti biasa.

Elemen Induk/Anak

Hierarki	Elemen
Elemen induk	ASX
Elemen anak	ENTRY, ENTRYREF

Keterangan

Elemen ini mendefinisikan perilaku atau tindakan yang diambil oleh Pemutar Media Windows saat menerima perintah skrip yang diberi label sebagai peristiwa. Peristiwa adalah jenis perintah skrip tertentu yang disematkan dalam aliran yang dikirim ke Pemutar Media Windows yang terdiri dari string ganda. String pertama adalah kata "peristiwa", dan string kedua adalah nama peristiwa. Nama peristiwa dalam string kedua harus cocok dengan nama peristiwa yang ditentukan dalam metafile. (Kecocokan tidak peka huruf besar/kecil.) Peristiwa dapat dikirim ke Pemutar Media Windows menerima aliran real-time, atau dapat disimpan dalam file .asf, .wma, atau .wmv yang dikirimkan sebagai aliran unicast sesuai permintaan. Saat Pemutar Media Windows menerima perintah skrip, perintah tersebut memproses peristiwa seperti yang didefinisikan oleh elemen EVENT.

Elemen ini mendefinisikan cakupan elemen ENTRY atau ENTRYREF yang diproses setiap kali Pemutar Media Windows menerima perintah skrip dengan peristiwa bernama. ENTRYREF dapat menjadi URL yang menunjuk ke halaman ASP. Dengan elemen ini, Anda dapat menentukan perilaku untuk pengalihan aliran mendekati real time, dibandingkan dengan perubahan aliran yang telah ditulis sebelumnya menggunakan referensi ke bagian konten lain atau metafiles Windows Media.

Saat Anda menggunakan halaman ASP untuk menghasilkan daftar putar, Anda harus menentukan nilai untuk Respons. Properti ContentType dan Respons. properti kedaluwarsa di halaman ASP karena masalah latensi dengan Pemutar Media Windows. Respons. ContentType harus berupa ekstensi nama file yang valid untuk metafiles Windows Media. Jenis yang valid termasuk .asf, .asx, .wma, .wax, .wmv, dan .wvx.

Lihat Platform SDK untuk detail tentang menggunakan objek Respons di ASP.

Elemen ini dapat muncul di mana saja dalam elemen ASX . Jika beberapa elemen EVENT dalam elemen ASX memiliki nilai yang identik untuk atribut NAME-nya, Pemutar Media Windows menggunakan kemunculan pertama dalam elemen ASX, dan mengabaikan semua yang lain. Ketika elemen EVENT memiliki atribut NAME yang berbeda, urutannya dalam elemen ASX tidak masalah.

Pemutar Media Windows membuang peristiwa yang diterimanya saat memproses peristiwa lain. Bersarangnya peristiwa tidak didukung. Saat Pemutar Media Windows dalam mode pratinjau, konten peristiwa tidak dibatasi oleh elemen PREVIEWDURATION; panjang penuh konten peristiwa dapat diputar bahkan jika durasi pratinjau untuk elemen ENTRY aktif kedaluwarsa sebelum akhir peristiwa.

Contoh

Dalam contoh ini, ketika Pemutar Media Windows menerima perintah skrip EVENT dan string perintah "Adlink" di media streaming yang direndernya, ia mencari daftar putar untuk EVENTNAME "Adlink". Pemutar Media Windows beralih dari aliran yang dirender dan memutar konten yang direferensikan di EVENT, "https://example.microsoft.com/adlink.htm".

ATRIBUT ENTRYCLIENTSKIP diatur ke TIDAK untuk mencegah klip PERISTIWA dilewati. Ini harus dimainkan.

Skrip WHENDONE="RESUME" menginstruksikan Pemutar Media Windows untuk melanjutkan pemutaran media sebelumnya yang dialihkannya segera setelah Adlink.asf selesai.

<ASX VERSION="3.0">
<ENTRY CLIENTSKIP="NO">
   <REF HREF="https://example.microsoft.com/clip1.asf" />
</ENTRY>
<EVENT NAME="Adlink" WHENDONE="RESUME">
   <ENTRYREF HREF="https://example.microsoft.com/adlink.htm" 
       CLIENTSKIP="NO" />
</EVENT>
</ASX>

Persyaratan

Persyaratan	Nilai
Versi	Pemutar Media Windows versi 7.0 atau yang lebih baru

Lihat juga

Referensi Elemen Metafile Windows Media

Referensi Metafile Windows Media

Pemutar Media Windows Object Model