Elemen ASX

[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 ASX mendefinisikan file sebagai metafile.

<ASX
   VERSION = "number"
   PREVIEWMODE = "YES" | "NO"
   BANNERBAR = "AUTO" | "FIXED"
>
</ASX>

Atribut

VERSION (diperlukan)

Angka desimal yang menunjukkan nomor versi sintaks untuk metafile. Atur ke 3 atau 3.0.

PREVIEWMODE (opsional)

Nilai yang menunjukkan apakah Pemutar Media Windows memasuki mode pratinjau sebelum memutar klip pertama.

Harus salah satu dari nilai berikut.

Nilai	Deskripsi
YES	Pemutar Media Windows memasuki mode pratinjau sebelum memutar klip pertama.
TIDAK	Nilai default. Pemutar Media Windows tidak memasuki mode pratinjau sebelum memutar klip pertama.

BANNERBAR (opsional)

Nilai yang menunjukkan apakah Pemutar Media Windows mencadangkan ruang untuk grafik banner.

Harus salah satu dari nilai berikut.

Nilai	Deskripsi
AUTO	Nilai default. Pemutar Media Windows mencadangkan ruang untuk bilah spanduk hanya ketika konten menyertakan satu.
FIXED	Pemutar Media Windows mencadangkan ruang tetap untuk grafik spanduk untuk setiap bagian konten yang diputar, apakah ada banner terkait.

Elemen Induk/Anak

Hierarki	Elemen
Elemen induk	Tidak ada. Elemen ASX harus menjadi elemen pertama di setiap metafile.
Elemen anak	ABSTRAK, PENULIS, SPANDUK, DASAR, HAK CIPTA, ENTRI, ENTRYREF, PERISTIWA, MOREINFO, PRATINJAUDURASI, PARAM, ULANGI, JUDUL

Keterangan

Empat karakter pertama dari daftar putar metafile harus "<ASX". Elemen lain yang ditentukan dalam cakupan elemen ASX, seperti TITLE dan AUTHOR, dikaitkan dengan informasi peragaan yang ditampilkan oleh Pemutar Media Windows.

Untuk Pemutar Media Windows, nomor versi sintaks adalah 3.0. Pemutar Media Windows mendukung semua versi sintaks metafile sebelumnya. Nilai yang dapat diterima untuk atribut VERSION mencakup 3.0 dan 3 (tanpa titik desimal).

Jika nilai atribut PREVIEWMODE adalah YA, Pemutar Media Windows segera memasuki mode pratinjau sebelum memutar klip pertama. Saat Pemutar Media Windows memasuki mode pratinjau, ia mempratinjau setiap klip yang dirujuk dalam metafile. Elemen PREVIEWDURATION menentukan durasi setiap pratinjau.

Atribut BANNERBAR menentukan apakah Pemutar Media Windows mencadangkan ruang untuk grafik banner. Spanduk adalah grafik yang ditampilkan di area tampilan video saat konten media sedang diputar. (Gunakan elemen BANNER untuk menambahkan banner ke konten.) Jika nilai BANNERBAR DIPERBAIKI, Pemutar Media Windows mencadangkan ruang spanduk untuk setiap konten media, apakah konten media memiliki spanduk. Jika sepotong konten media tidak memiliki spanduk yang terkait dengannya, ruang yang disediakan untuk satu berwarna hitam. Jika nilai atribut BANNERBAR adalah AUTO, Pemutar Media Windows mencadangkan ruang untuk banner hanya ketika konten media menyertakannya.

Jika Anda membuat metafile dengan beberapa klip (elemen ENTRY atau ENTRYREF) dan mengatur nilai atribut BANNERBAR ke AUTO, Pemutar Media Windows mungkin mengubah ukuran untuk memungkinkan spasi untuk grafik spanduk untuk satu klip, lalu mengubah ukuran lagi jika klip berikutnya tidak berisi grafik banner. Jika Anda ingin ukuran jendela tetap sama (kecuali saat ukuran video berubah), gunakan nilai TETAP untuk atribut BANNERBAR .

Ruang yang disediakan untuk grafik spanduk adalah 32 piksel tinggi dengan lebar 194 piksel. Ruang yang dipesan muncul di bawah konten video yang dirender dan 6 piksel di atas tepi bawah area video, memungkinkan ruang untuk batas area video 6 piksel. Ruang banner yang dipesan berpusat secara horizontal.

Pemutar Media Windows merender grafik yang dimulai di piksel paling kiri ruang banner. Jika grafik mengisi seluruh ruang, grafik akan muncul di tengah secara horizontal. Jika tidak, akan ada ruang di belakang. Perhatikan bahwa lebar minimum Pemutar Media Windows selalu lebih lebar dari ukuran klip video, terlepas dari nilai atribut BANNERBAR.

Contoh

<ASX VERSION="3.0" PREVIEWMODE="YES" BANNERBAR="auto"  >
   <ENTRY HREF="https://sample.microsoft.com/sample1.ASX" />
</ASX>

Persyaratan

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

Lihat juga

Referensi Elemen Metafile Windows Media

Referensi Metafile Windows Media