Peristiwa Player.ScriptCommand

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

Peristiwa ScriptCommand terjadi ketika perintah atau URL yang disinkronkan diterima.

Sintaks

Player.ScriptCommand(
  scType,
  Param
)

Parameter

scType

String yang menentukan jenis perintah skrip.

Param

String yang menentukan perintah skrip.

Nilai kembali

Kejadian ini tidak mengembalikan nilai.

Keterangan

Perintah dapat disematkan di antara suara dan gambar file atau aliran Windows Media. Perintah adalah sepasang string Unicode yang terkait dengan waktu yang ditentukan dalam aliran. Ketika aliran mencapai waktu yang terkait dengan perintah, kontrol Pemutar Media Windows mengirimkan peristiwa ScriptCommand dengan dua parameter. Satu parameter menentukan jenis perintah yang dikirim, dan parameter lainnya menentukan perintah . Jenis parameter digunakan untuk menentukan bagaimana parameter perintah diproses. Semua jenis perintah dapat disematkan dalam file atau aliran yang akan ditangani oleh peristiwa ScriptCommand .

Tabel berikut ini mencantumkan jenis perintah skrip yang diproses secara otomatis oleh Pemutar Media Windows.

Jenis Deskripsi
CAPTION Kontrol menampilkan teks terkait dalam DIV yang ditentukan oleh ClosedCaption. captioningID.
ACARA Memberi tahu kontrol untuk menjalankan instruksi yang ditentukan untuk peristiwa yang ditentukan.
FILENAME Kontrol mereset properti URL-nya , mencoba membuka file yang ditentukan, dan segera mulai memutar aliran baru.
OPENEVENT Buffer perintah jenis PERISTIWA terkait untuk eksekusi tepat waktu skrip PERISTIWA.
LIRIK TERSINKRONISASI Parameter Param berisi teks lirik yang disinkronkan. Pemutar Media Windows menampilkan teks lirik di area caption tertutup dari fitur Sedang Diputar.
TEXT Kontrol menampilkan teks terkait dalam DIV yang ditentukan oleh ClosedCaption. captioningID.
URL Kontrol secara otomatis membuka URL yang ditentukan menggunakan browser Internet default jika Pengaturan. properti invokeURLs diatur ke true.

Anda dapat menyematkan jenis perintah lainnya selama Anda menyediakan kode timbal balik untuk menangani perintah. Meskipun perintah yang tidak diketahui diabaikan oleh kontrol Pemutar Media Windows, perintah tersebut masih diserahkan ke peristiwa ScriptCommand.

Perintah URL yang diterima oleh kontrol Pemutar Media Windows dipanggil secara otomatis di browser Web default Anda jika Pengaturan.properti invokeURLs diatur ke true. Anda dapat menggunakan Pengaturan. properti defaultFrame untuk menentukan bingkai target tempat halaman web muncul.

URL yang dikirim ke Pemutar Media Windows diproses relatif terhadap URL dasar yang ditentukan oleh Pengaturan.properti baseURL. URL dasar digabungkan dengan URL yang relatif ditentukan, menghasilkan URL yang sepenuhnya ditentukan yang diteruskan sebagai parameter perintah oleh peristiwa ScriptCommand .

Kontrol Pemutar Media Windows selalu memproses perintah jenis URL masuk dengan cara berikut:

  1. Perintah jenis URL diterima.
  2. Pengaturan. baseURL digunakan untuk membuat URL lengkap dari URL relatif yang ditentukan dalam perintah skrip.
  3. ScriptCommand dipanggil.
  4. Setelah ScriptCommand kembali, Pengaturan. invokeURLs dicentang.
  5. Jika Pengaturan. invokeURLs adalah true dan perintahnya adalah jenis URL, URL yang ditentukan dipanggil. Jika Pengaturan. invokeURLs salah atau jika perintah bukan jenis URL, perintah diabaikan.

Saat menulis file Windows Media, Anda dapat menentukan bingkai mana URL baru ditampilkan dengan menggabungkan dua ampersand dan nama bingkai di bidang parameter. Contoh di bawah ini menggambarkan parameter ScriptCommand yang khas. Ini menentukan bahwa mypage URL harus diluncurkan dalam bingkai myframe .

scType = "URL"
Param = https://myweb/mypage.html&&myframe

Peristiwa ScriptCommand tidak dipanggil jika file sedang dipindai (diteruskan cepat atau dibalik dengan cepat).

Nilai parameter peristiwa ditentukan oleh Pemutar Media Windows, dan dapat diakses atau diteruskan ke metode dalam file JScript yang diimpor menggunakan nama parameter yang diberikan. Nama parameter ini harus diketik persis seperti yang ditunjukkan, termasuk kapitalisasi.

Persyaratan

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

Lihat juga

Objek Pemutar

Player.URL

Settings.baseURL

Settings.defaultFrame

Settings.invokeURLs