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

时间:2022-04-15 05:04:43

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

有人问我:你上大学的时候,有加入过学生会吗?读大学有没有必要加入学生会?

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

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

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

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

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

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

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

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

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

话说上一回,老周给大伙伴们介绍了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();
}
}

后台的触发器便用 ToastNotificationActionTrigger类型。

现在我们来看一下,运行程序,等Toast通知出现后,把程序关了。然后在Toast通知上选择一个项,然后提交。

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

然后再次启动应用程序,可以看到结果了。

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

如何,这Win10的Toast通知是不是很牛X呢。由于小妹妹正在拿着我的920玩,所以就不用手机运行了,手机模拟器没有安装,大伙儿有兴趣的可以耍耍。

示例源码:http://files.cnblogs.com/files/tcjiaan/toastActivationApp.zip