audio (Skema XML Toast)

  • Artikel

Menentukan suara yang akan diputar ketika pemberitahuan toast ditampilkan. Elemen ini juga memungkinkan Anda untuk membisukan audio pemberitahuan toast apa pun.

Hierarki elemen

<Roti panggang>
<Audio>

Sintaks

<audio src?    = string
       loop?   = boolean
       silent? = boolean />

Kunci

? opsional (nol atau satu)

Atribut dan Elemen

Atribut

Atribut Deskripsi Jenis Data Diperlukan Nilai default
Loop

Atur ke true jika suara harus diulang selama toast ditampilkan; false untuk diputar hanya sekali. Jika atribut ini diatur ke true, atribut durasi dalam elemen toast juga harus diatur. Ada suara khusus yang disediakan untuk digunakan saat mengulang. Perhatikan bahwa aplikasi UWP tidak mendukung perulangan audio atau roti panggang durasi panjang.

 boolean Tidak salah
diam

Benar untuk membisukan suara; false untuk memungkinkan suara pemberitahuan toast diputar.

 boolean Tidak salah
src

Berkas media yang akan diputar sebagai pengganti suara asali. Di Windows, atribut ini dapat memiliki salah satu nilai string berikut:

  • ms-winsoundevent:Notification.Default
  • ms-winsoundevent:Notification.IM
  • ms-winsoundevent:Notification.Mail
  • ms-winsoundevent:Notification.Reminder
  • ms-winsoundevent:Notification.SMS
  • ms-winsoundevent:Notification.Looping.Alarm
  • ms-winsoundevent:Notification.Looping.Alarm2
  • ms-winsoundevent:Notification.Looping.Alarm3
  • ms-winsoundevent:Notification.Looping.Alarm4
  • ms-winsoundevent:Notification.Looping.Alarm5
  • ms-winsoundevent:Notification.Looping.Alarm6
  • ms-winsoundevent:Notification.Looping.Alarm7
  • ms-winsoundevent:Notification.Looping.Alarm8
  • ms-winsoundevent:Notification.Looping.Alarm9
  • ms-winsoundevent:Notification.Looping.Alarm10
  • ms-winsoundevent:Notification.Looping.Call
  • ms-winsoundevent:Notification.Looping.Call2
  • ms-winsoundevent:Notification.Looping.Call3
  • ms-winsoundevent:Notification.Looping.Call4
  • ms-winsoundevent:Notification.Looping.Call5
  • ms-winsoundevent:Notification.Looping.Call6
  • ms-winsoundevent:Notification.Looping.Call7
  • ms-winsoundevent:Notification.Looping.Call8
  • ms-winsoundevent:Notification.Looping.Call9
  • ms-winsoundevent:Notification.Looping.Call10

Lihat bagian keterangan untuk informasi tentang suara kustom.

 string Tidak Tidak ada

 

Elemen Anak

Tidak ada.

Elemen Induk

Elemen Induk Deskripsi
Roti panggang

Elemen toast dasar, yang berisi setidaknya satu elemen visual .

 

Keterangan

Aplikasi UWP yang menargetkan platform desktop mendukung suara pemberitahuan toast kustom pada Windows 10, versi 1511 (build 10586) dan yang lebih baru. Pada versi sebelumnya, Anda dapat memilih dari daftar ms-winsoundevent nilai yang tercantum untuk atribut src dalam tabel di atas. Untuk informasi selengkapnya tentang suara pemberitahuan toast kustom, lihat Audio kustom pada toast.

Jika Anda menentukan jalur file kustom di payload aplikasi, suara default (pemberitahuan, panggilan, alarm, atau pengingat) akan diputar berdasarkan skenario yang ditentukan.

Contoh

Kode berikut menunjukkan contoh tag ini.

<audio src="ms-winsoundevent:Notification.Mail" loop="false"/>

Kode berikut menunjukkan tag ini digunakan untuk mematikan suara audio pemberitahuan toast.

<audio silent="true"/>

Lihat juga