音频 (Toast XML 架构)

  • 项目

指定显示 toast 通知时要播放的声音。 此元素还允许您将任何 toast 通知音频静音。

元素层次结构

<toast>
<声卡>

语法

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

键

? 可选 (零个或一个)

特性和元素

特性

属性 说明 数据类型 必须 默认值
圈

如果声音应重复显示，只要显示 toast，则设置为 true ; 如果 仅播放一次，则为 false。 如果此特性设置为true，则还必须设置toast元素中的duration特性。 提供了在循环时要使用的特定声音。 请注意，UWP 应用不支持循环音频或持续时间 toast。

 boolean 否 false
silent

若要使声音静音，则为True ;如果允许播放 toast 通知声音，则为 false。

 boolean 否 false
src

播放来代替默认声音的媒体文件。 在 Windows 上，此属性可以包含以下字符串值之一：

  • winsoundevent： Notification。默认值
  • winsoundevent:Notification
  • winsoundevent： Notification。 Mail
  • winsoundevent： Notification。提醒
  • winsoundevent： Notification。 SMS
  • winsoundevent： Notification。警报
  • ms-winsoundevent： Alarm2
  • ms-winsoundevent： Alarm3
  • ms-winsoundevent： Alarm4
  • ms-winsoundevent： Alarm5
  • ms-winsoundevent： Alarm6
  • ms-winsoundevent： Alarm7
  • ms-winsoundevent： Alarm8
  • ms-winsoundevent： Alarm9
  • ms-winsoundevent： Alarm10
  • winsoundevent： Notification。调用
  • ms-winsoundevent： Call2
  • ms-winsoundevent： Call3
  • ms-winsoundevent： Call4
  • ms-winsoundevent： Call5
  • ms-winsoundevent： Call6
  • ms-winsoundevent： Call7
  • ms-winsoundevent： Call8
  • ms-winsoundevent： Call9
  • ms-winsoundevent： Call10

有关自定义声音的信息，请参阅 "备注" 部分。

 字符串 否 无

 

子元素

无。

父元素

父元素 说明
toast

基本 toast 元素，其中至少包含一个 可视 元素。

 

备注

面向桌面平台的 UWP 应用支持 Windows 10 版本 1511) 10586 (版本上的自定义 toast 通知。 在早期版本中，可以从为上表中的src属性列出的值列表 ms-winsoundevent 中进行选择。 有关自定义 toast 通知声音的详细信息，请参阅 toast 上的自定义音频。

如果在应用负载中指定自定义文件路径，则将根据指定的方案播放默认声音 (通知、呼叫、警报或提醒) 。

示例

下面的代码显示了此标记的一个示例。

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

以下代码显示了用于使 toast 通知音频静音的标记。

<audio silent="true"/>

请参阅