阅读目录:

1. 概述
2. toast通知的结构
3. 视觉区域(Visual)
4. 行为(Actions)
5. 特定场景下的Toast通知
6. 带多内容的通知
7. 带行为的通知(例子1)
8. 带行为的通知(例子2)
9. 带文本输入框和行为的通知(例子1)
10. 带文本输入框和行为的通知(例子2)
11. 带下拉框输入和行为的通知
12. 提醒通知
13. 前后台激活的例子
14. <visual>和<audio>的Schema
15. <actions>的Schema
16. 系统行为的附加行为

Windows10的自适应和交互式toast通知是一个新特性。它可以让你：

创建灵活的toast通知，包括内嵌图片及更多的内容，不在局限于之前Windows 8.1和Windows Phone 8.1提供的toast模板。

关于Windows 8.1和Windows Phone 8.1遗留的模板介绍，请看toast template catalog。

概述

在Windows10中，有以下几个方面，可以自定义已经存在的toast模板。

• 移动一个限制的模板模型到一个灵活的自适应模板。
• 有能力在payload中，增加自定义行为和系统行为。
• 为主要的toast通知提供三个不同的激活类型。
• 有能力为特殊场景创建通知，包括闹钟、日历、来电。

上面提到的内容本文都会介绍到。

toast通知的结构

在windows10中，开发者使用xml构造一个toast通知，它包含以下几个关键节点。

XML表示用户在界面上能看到的视觉内容，包括文本和图片，同样包含开发者想在通知内增加的自定义交互行为。

下面是个简单例子：

<toast launch="app-defined-string">
  <visual>
    <binding template="ToastGeneric">
      <text>Sample</text>
      <text>This is a simple toast notification example</text>
      <image placement="AppLogoOverride" src="oneAlarm.png" />
    </binding>
  </visual>
  <actions>
    <action content="check" arguments="check" imageUri="check.png" />
    <action content="cancel" arguments="cancel" />
  </actions>
  <audio src="ms-winsoundevent:Notification.Reminder"/>
</toast>

视觉区域(Visual)

在visual节点内部，要求有一个binding节点，它包含visual模板信息和toast的视觉内容。

它不同于tile通知，可以在不同的tile大小上支持多个模板。Windows10中UWP应用的toast通知只有一个模板名称“ToastGeneric”。 相比之前遗留下的限制性模板，它有以下几个优势:

• 灵活性：开发者可以改变toast的内容，比如添加一个文本行、添加一个图片或者改变应用icon显示的缩略图等等。不用担心由于模板名称不匹配，而改变整个模板或者创建一个无效的payload。
• 自适应：开发者可以为toast通知使用同样的代码去构造同样的payload，其目标是实现各种windows设备类型统一，比如手机、平板、桌面PC、甚至Xbox，这些不同的设备都将允许这个通知，在用户自己的UI策略上显示适当的视觉区域和互动模型。

所有这些属性都会在visual部分和它的子节点中被支持。
关于更多的例子，请看下面Samples部分。

行为(Actions)

在Windows10 UWP应用中，开发者可以添加自定义交互行为到toast通知里，它允许用户在app外做更多的事情。开发者能指定2个类型的节点：

• <action> 通过此节点开发者能在toast通知内部指定3个自定义或系统行为。
• <input> 开发者使用户能够在toast通知内输入信息，比如在toast通知内直接输入信息进行内容回复。

提示： <action>和<input>在windows设备族里面是自适应的。比如，在windows移动和桌面上， <action>展示给用户的是一个触摸或点击，一个文本标记< input>展示的是一个输入框，用户可以通过键盘或虚拟键盘进行输入。 可能在不久后未来的设备上，行为是通过声音来触发的，文本框是通过用户语言识别来输入的。 toast通知内部的交互是能够适配这样的互动模式，消息内容显示能在设备上进行自适应的可视范围调整。

当一个行为被用户触发时，开发者能在<action>内activationType属性上选择下面的某一种方式去做对应处理：

• 激活App在前台显示。 通过行为触发时指定的参数来判断并导航到对应的页面或内容。
• 激活App的后台任务去处理，不会在前台影响用户。
• 通过协议(protocol)激活另外一个App。
• 执行一个指定的系统行为。 UWP当前可用的系统行为是关闭和取消闹钟或日历计划，这会在下面的章节进一步讲解。

所有上面提到的属性都会在<actions>部分和它的子节点上支持。

关于toast内部的交互，请看后面的例子。

声音(Audio)

在windows10 UWP应用中，其<audio>节点内容和WP8.1版本保持不变。

移动设备能通过ms-appx和ms-appdata自定义声音，但是桌面版不行。其二者都可以使用ms-winsoundevent。 关于toast上声音的更多信息，请看audio schema page。

特定场景下的Toast通知

在windows10上，开发者可以为闹钟、日历、来电去使用toast通知。 统一标准的toast通知从视觉上来看是一致的，用一些额外的UI策略会使通知适用每一个场景。

一个提醒的toast通知可以一直停在用户屏幕上，直到用户触发它的行为去忽略它或使用它。在windows移动设备上，提醒toast通知也将会同样的显示。

除了上面提醒的通知与行为，闹钟通知会自动播放声音。

来电通知会在windows移动设备上全屏显示。

这些可在toast通知的根节点<toast>内，通过指定“scenario”属性来完成。

XML例子

请注意下面所有的toast通知是从windows桌面预览版系统得到的，toast通知的移动版本有时候会发生崩溃，这在后面会进行解释。

带多内容的通知

你可以在toast通知上使用多行文本，一个随意的小照片去覆盖应用的logo，一个随意内嵌的图片缩略