转载

【Win 10 应用开发】Toast通知激活应用——前台&后台

老周最近热衷于讲故事，接下来还是讲故事时间。

有人问我：你上大学的时候，有加入过学生会吗？读大学有没有必要加入学生会？

哎哟，这怎么回答呢，从短期来说，加入学生会有点用，至少可以娱乐一下，运气好的话，说不定能遇到红颜知己，但这概率相当低。从长远发展看嘛，是没什么用。老周当年读了四年本科，在学生会混了四年，什么名堂也没混出来。

一方面老周向来不求虚名，所以也没去参选所谓的什么部长、主席之类的，这些“官衔”听起来很高大上，实际上很庸俗蠢。既然没兴趣，因而老周更不需要去搞那些见不得人的勾当，什么勾当？你懂的。其次，老周没感觉到这些职务，对将来的职业生涯发展有什么帮助，基本上属于混日子罢了。

老周当初一上大学，本不想进什么学生会天地会之类的，之所以进了，纯属意外，简直太意外了，事情是这样的。话说那天学生会招新，尽管老周的母校比较老旧，但校园里还是被各处摆摊招新的学兄学姐们弄得像大观园似的，热闹非常。

谁不知道，大观园里美女多，于是我宿舍的室友开始动心了，有两个人鼓起勇气，决定明天去面试。本来跟我没什么关系，谁想第二天，又有一位室友感兴趣了，他们索性商量全宿舍一起出动。老周本不想去，就被他们硬拉着去。

一伙漫无目的地随处看，我以为他们是去看美女的，原来他们还真的去面试了，走着走着，我们进入了一个教室，里面坐着几位师兄和师姐。进去前要在门口登记，写上个人信息，然后排队面试（教室里都没几个人，排什么队），我说我不是来面试的，是陪室友来玩玩的。听我一说完，一位师兄叫我出去走廊外面等。

正当我往外走时，另一位师兄又把我叫回来，说既然来了就面面试吧，没事的。这时候我才知道，他们是要招书法高手的。老周虽不敢当什么高手，但从小就握过几年毛笔，不防耍耍。就这样，老周就莫名其妙地进了学生会。

想来有趣，本来想进的，没进；我本不想进的，反而进了。真是世事无常，祸福相依啊。

=========================================================

故事讲完了，下面说正经话。

话说上一回，老周给大伙伴们介绍了win 10中Toast通知的新型模板，既包含有旧版本的兼容格式，也有用于通用平台的“自适应”通知。前一文章中，老周主要介绍了XML文档的基本格式，并演示了两个例子。

今天，咱们探讨一下如何在Toast通知中使用交互命令，并通过交互命令激活应用程序。所谓交互命令，就是在Toast通知的界面上添加一些可以让用户操作的元素，来与应用程序进行互动。这些交互元素主要有：

1、按钮。用action元素来指定，用户点击按钮后会激活应用程序，并把用户所点击的按钮的参数作为激活参数传递给应用程序。

2、输入框。就是一个文本框，用户可以在里面输入文本。

3、选择列表。类似于下拉列表框，用户可以在里面选择一个项。

这些交互元素都统一放到actions元素下面。

举个例子，比如这样：

<toast>   <visual>     <binding template="ToastGeneric">       <text>唱山歌</text>       <text>一起去唱山歌吧.</text>       <image placement="appLogoOverride" src="c.png" />     </binding>   </visual>   <actions>     <action content="报名" arguments="join" imageUri="jn.png" />     <action content="不去" arguments="cancel" />   </actions> </toast>

大家可以想象一下这个Toast通知是什么样子的，现在不截图给你看，待会儿咱们做示例时再看。

首先，visual元素在前一篇烂文中讲过，是描述toast通知的可视化部分，第一个text被视为标题，所以显示出来字体较大，第二个text作为正文，显示一行文本。image元素指定一个图像，因为设置了placement="appLogoOverride"，表明这个图像会替换应用的默认图标，显示在通知的左上角。

接下来，重点关注actions元素，actions元素下面专门用来放置交互命令，有两个元素可用：

<action>：表示定义一个命令按钮。例如：

<action content = "确定"  arguments = "yes"  activationType ="foreground或background" imageUrl="b.png"  />

content表示要在按钮上显示的文本，上面例子在按钮上显示“确定”。imageUrl表示显示在按钮上的图标，如果不用图标，就可以不设置imageUrl属性。arguments用来指定一个参数，这个参数是你自己定的，比如我这里叫yes，当用户点击按钮后，arguments的值会传递给应用程序，这样应用程序才会知道你到底点击了哪个按钮。

activationType指示以何种方式激活应用程序，如果值为foreground，则表明toast通知将在前台激活应用程序，这时候用户可以看见应用程序；如果值为background，表明toast通知通过后台方式激活应用，此时用户看不到应用程序，后台激活必须指定一个后台任务，当激活时就会执行后台任务。如果值为protocol，表示将通过协议来激活应用程序。

如果希望用户可以在Toast通知上输入内容，可以这样定义XML：

<input id="name" type="text" />

Toast通知上会显示一个文本框，id属性是必须指定的，而且必须是actions中的唯一值，不能重复，这个id值在激活应用程序时会传递给应用。type属性指定input元素的类型，text表示文本框，让用户输入文本。如果是selection表示显示一个列表选择框，用户只能从中选择一个项。

如果type为selection，那么input元素下会包含N个selection元素，每个selection元素表示一个选项，如

<input id="age" type="selection">     <selection content="五岁" id="5" />     <selection content="七岁" id="7" /> </input>

上面例子，定义了两个选项，每个selection的id值必须唯一，它表示该项的值，这个id也会传递给被激活的程序。content表示项中显示的文本，用来给你看的。即当toast弹出时，在下拉列表中，你看到的是五岁、七岁两个选项。

下面我们来实战一下，先看Toast通知如何从前台激活应用。

首先构造XML文档。

string visual = "<visual>" +  "<binding template=/"ToastGeneric/">" +      "<text>宇宙第一应用</text>" +      "<text>应用正在收集您的信息。</text>" +  "</binding>" +                  "</visual>"; string actions = "<actions>" +  "<input id=/"name/" type=/"text/" placeHolderContent=/"请输入姓名/" />" +  "<input id=/"city/" type=/"text/" placeHolderContent=/"请输入城市/" />" +  "<action content=/"确定/" arguments=/"ok/" />" +  "<action content=/"取消/" arguments=/"cancel/" activationType=/"foreground/" />" +                  "</actions>"; string toastXml = $"<toast>{visual}{actions}</toast>";

有一点大伙要注意，当input和action元素同时使用时，input元素必须放在action元素的前面。placeHolderContent属性主要设置占位文本，即当文本框中没有输入任何内容时显示的文本。

上面的Toast通知定义了两个可供输入的文本框，以及两个命令按钮。

下面代码显示通知。

// 加载XML文档             XmlDocument doc = new XmlDocument();             doc.LoadXml(toastXml);             // 显示通知             ToastNotification notification = new ToastNotification(doc);             ToastNotifier notifier = ToastNotificationManager.CreateToastNotifier();             notifier.Show(notification);

正因为应用程序是被前台激活的，所以肯定要为Application类作激活处理，在App类中，重写基类的OnActivated方法。

protected override void OnActivated(IActivatedEventArgs args)   {    // 判断激活类型    // 确认是由Toast通知激活应用    if (args.Kind == ActivationKind.ToastNotification)    {     // 转换参数类型     ToastNotificationActivatedEventArgs toastargs = (ToastNotificationActivatedEventArgs)args;     // 获取页面引用     Frame root = Window.Current.Content as Frame;     if (root == null)     {      root = new Frame();      Window.Current.Content = root;     }     if (root.Content == null)     {      root.Navigate(typeof(MainPage));     }     MainPage page = (MainPage)root.Content;     // 判断用户点击哪个按钮     string activeargs = toastargs.Argument;     if (activeargs == "ok") //确定按钮     {      // 获取用户输入的内容      string name = toastargs.UserInput["name"] as string;      string city = toastargs.UserInput["city"] as string;      page.ShowTextFromForeactivation($"用户点击了确定按钮，输入的内容为：/n姓名：{name}/n城市：{city}。");     }     else //取消按钮     {      page.ShowTextFromForeactivation("用户点击了取消按钮。");     }    }    Window.Current.Activate();   }

先要通过方法参数的Kind属性来判断一下应用程序是不是被Toast通知所激活的，如果值是ToastNotification，证明应用程序是被Toast通知激活的。

然后要把方法参数的类型转化为ToastNotificationActivatedEventArgs类型，ToastNotificationActivatedEventArgs类专用于Toast通知的激活。

Argument属性中取得的值就是被点击的action的arguments属性中的值，上面我定义的toast有两个action，arguments的值分别为ok和cancel，如果用户点击了确定按钮，那么从ToastNotificationActivatedEventArgs对象的Argument属性得到的值为ok，否则就是cancel。

UserInput属性获取的就是input元素的值，属性类型为ValueSet，实际上是一个字典类型。Key为Toast通知中input元素的id，Value的值是input元素中输入的内容。通过UserInput属性，程序就知道用户在文本框中输入了什么内容。

运行应用程序，当通知弹出时，输入相关内容，如下图。

【Win 10 应用开发】Toast通知激活应用——前台&后台

输入一些文本后，然后点击确定按钮，然后应用程序被激活，会看到主页面上显示从Toast通知传递到应用程序的输入数据。如下图所示。

【Win 10 应用开发】Toast通知激活应用——前台&后台

---------------------------------------------------------------------------------------------------

上面演示的是Toast通知从前台激活应用程序，下面来看看后台激活。Toast通知从后台激活应用程序，用户不会看到应用程序界面，但应用程序会在后台任务中处理从Toast通知传递到应用程序的数据。

要实现从后台处理Toast通知，首先要实现一个后台任务。记住后台任务要在一个独立的Runtime组件项目中。后台的实现代码如下：

public sealed class ToastBgTask : IBackgroundTask {  public async void Run(IBackgroundTaskInstance taskInstance)  {   var deferral = taskInstance.GetDeferral();   ToastNotificationActionTriggerDetail details = taskInstance.TriggerDetails as ToastNotificationActionTriggerDetail;   if (details != null)   {    // 先确认用户点击了yes按钮    string cmdargs = details.Argument;    if (cmdargs == "yes")    {     // 获取选择的项     object value = details.UserInput["ut"];     // 保存数据     StorageFolder local = ApplicationData.Current.LocalFolder;     JsonObject jsobj = new JsonObject();     jsobj.SetNamedValue("updatetime", JsonValue.CreateNumberValue(Convert.ToDouble(value)));     StorageFile newFile = await local.CreateFileAsync("data.json", CreationCollisionOption.ReplaceExisting);     await FileIO.WriteTextAsync(newFile, jsobj.Stringify(), Windows.Storage.Streams.UnicodeEncoding.Utf8);    }   }   deferral.Complete();  } }

当Toast通知激活后台任务后，可以从 taskInstance.TriggerDetails属性获取到一个ToastNotificationActionTriggerDetail对象实例。和前台激活一样，通过Argument属性可以获取Toast通知中被用户点击的action元素的参数。从UserInput属性可以获取到input元素的id值。

后台任务完成后，记得要在主项目中引用，这个老周已经重复了几千遍了。

然后打开清单文件，在Package/Applications/Application节点下添加后台任务声明。

<Extensions>       <Extension Category="windows.backgroundTasks" EntryPoint="BackgroundTasks.ToastBgTask">         <BackgroundTasks>           <Task Type="general"/>         </BackgroundTasks>       </Extension>     <
/Extensions>

由于在后台任务中，是把用户在Toast通知上选择的项保存到本地文件中，所以在主应用中，可以读出文件的内容，并显示出来。

protected override async void OnNavigatedTo(NavigationEventArgs e) {  try  {   // 读入后台保存的内容   StorageFolder local = ApplicationData.Current.LocalFolder;   StorageFile dataFile = await local.GetFileAsync("data.json");   if (dataFile == null) return;   string jsstr = await FileIO.ReadTextAsync(dataFile, Windows.Storage.Streams.UnicodeEncoding.Utf8);   JsonObject jsobj = null;   if (JsonObject.TryParse(jsstr, out jsobj))   {    double d = jsobj.GetNamedNumber("updatetime");    tbResultFromBackActivate.Text = $"你选择了每隔{d:N0}天更新一次。";   }   await dataFile.DeleteAsync();  }  catch(Exception ex)  {   Debug.WriteLine($"文件读取异常：{ex.Message}，异常类型：{ex.GetType().Name}。");  } }

最后，我们实现显示Toast通知的代码。

string visual = "<visual>" +      "<binding template=/"ToastGeneric/">" +       "<text>无敌应用</text>" +       "<text>请选择更新间隔天数。</text>" +      "</binding>" +     "</visual>"; string actions = "<actions>" +      "<input id=/"ut/" type=/"selection/" defaultInput=/"5/">"+       "<selection id=/"3/" content=/"3天/" />" +       "<selection id=/"5/" content=/"5天/" />" +       "<selection id=/"10/" content=/"10天/" />" +      "</input>" +      "<action content=/"是/" activationType=/"background/" arguments=/"yes/" />" +      "<action content=/"否/" activationType=/"background/" arguments=/"no/" />" +     "</actions>"; string toastXml = $"<toast>{visual}{actions}</toast>"; XmlDocument doc = new XmlDocument(); doc.LoadXml(toastXml); ToastNotification notification = new ToastNotification(doc); ToastNotifier notifier = ToastNotificationManager.CreateToastNotifier(); notifier.Show(notification);

input元素的type为selection，表示Toast通知上的输入行为为列表选择，并使用三个selection元素定义了三个选项。注意，在input元素中，defaultInput属性指定输入控件的默认值。如果type为text，该属性设置默认的文本；在本例中，type为selection， 所以默认值就是希望默认被选中的项的id值 。

似乎一切就绪了，实际上我们还有很关键一步没有做——注册后台任务，清单文件中仅仅是声明，而要希望让Toast通知的操作激活后台任务，还需要对后台任务进行注册。

private async void RegToastBackgroundTask() {  // 判断一下是否允许访问后台任务  var res = await BackgroundExecutionManager.RequestAccessAsync();  if (res == BackgroundAccessStatus.Denied || res == BackgroundAccessStatus.Unspecified)  {   return;  }  Type taskType = typeof(BackgroundTasks.ToastBgTask);  var task = BackgroundTaskRegistration.AllTasks.Values.FirstOrDefault(t => t.Name == taskType.Name);  if (task == null)  {   // 注册后台任务   BackgroundTaskBuilder bd = new BackgroundTaskBuilder();   bd.Name = taskType.Name;   bd.TaskEntryPoint = taskType.FullName;   // 声明触发器   ToastNotificationActionTrigger trigger = new ToastNotificationActionTrigger();   bd.SetTrigger(trigger);   task = bd.Register();  } }