【WP 8.1开发】自定义(RAW)通知的使用

继续前面的话题,还是推送通知。上一篇文章中遗留了RAW通知的推送没有给各位演示,特特地留到现在,不为别的,只为这个RAW通知有点意思,玩起来会比较有意思。官方文档将RAW通知译为“原始通知”,这里还是沿用官方的翻译。

在开始吹牛之前,先说一说与推送通知相关的要点。

有人说,如果我有22222222个客户端,岂不是都要获取每个手机客户端的通道URL来推送吗?是的。于是有人想到了所谓的“极光推送”,忽悠人的,“极光”显然偷换了概念。我们得明确,在什么情况下才会考虑使用推送。

推送好比服务器与手机客户端的“私人对话”,即当我们要为每一位客户发送个性化的消息时,才叫推送,说白了,就是每个用户收到的消息不相同,比如QQ就是这情况,每人的聊天记录都不相同。要是你打算向所有客户发送相同的信息,就不应该使用推送,使用更简单处理的Socket通信、或干脆用Web/WCF服务,把消息放到服务上,每个客户端自动去读取。你可以结合后台任务,特别计划后台,可以控制信息更新的频率(比如每天获取一次),获取到更新信息再通过Toast或磁贴来提醒一下用户就好了。

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

好了,废话结束,下面是正文。

RAW通知比较灵活,它不像Toast、磁贴、锁屏通知那样需要严格遵守固定的XML格式,RAW通知的内容或结构都可以自己来定义,然后把通知内容POST到推送通道URL即可,在发送时建议使用UTF-8编码,这样遇到中文字符也不至于在客户端收到乱码,别然并不绝对地说一定会变成乱码,但是谨慎一点肯定不是坏事。

 

在手机客户端,一般我们会结合后台任务来接收RAW通知,这样做的好处在于:

1、后台任务可以独立、有计划、有条件地运行,既不受前台UI影响,也不至于影响系统性能。大家都知道,WP手机是必须保持它刷刷刷地流畅的,不能因为我们开发的应用让系统不再刷刷刷,这样很不好。

2、有了后台接收,就算应用不在运行,都可以保证收到通知,前提是要有网络可用。

 

好,我想一想,给大家做个什么演示好呢?这样吧,为了使示例更容易理解,假设我的服务器端是一个电子商务平台,专门销售山寨七匹林男装的,每当有新的山寨品上架,服务会自动通知指定客户优惠打折的通知,我们就用RAW通知来实现。

1、启动VS,新建一个WP 8.1 应用程序。

2、在解决方案中添加一个“Windows 运行时组件”的项目,如下图。

注意,是Windows运行时组件,不是类库,不要创建类库项目。

项目名字你自己取,比如叫“后台怪兽”也行。这个windows 运行时组件项目用来定义咱们的后台任务。

 

3、声明一个类,并且这个类必须实现Windows.ApplicationModel.Background.IBackgroundTask接口,这个接口包含一个Run方法,我们要实现这个方法。

    public sealed class NotifiBackTask:Windows.ApplicationModel.Background.IBackgroundTask
    {
        public void Run(Windows.ApplicationModel.Background.IBackgroundTaskInstance taskInstance)
        {
            // 在这里编写后台处理代码

        }
    }

下面是后台的实现代码。

 

        public void Run(Windows.ApplicationModel.Background.IBackgroundTaskInstance taskInstance)
        {
            // 在这里编写后台处理代码
            Windows.Networking.PushNotifications.RawNotification notification = taskInstance.TriggerDetails as Windows.Networking.PushNotifications.RawNotification;

            if (notification != null)
            {
                // 获取RAW通知的内容
                string message = notification.Content;
                // 由于内容是以|作为分隔符的,所以我们要取得标题和内容
                string[] items = message.Split('|');
                // 保存数据
                Windows.Storage.ApplicationData.Current.LocalSettings.Values["title"] = items[0];
                Windows.Storage.ApplicationData.Current.LocalSettings.Values["content"] = items[1];
                // 更新磁贴
                Windows.Data.Xml.Dom.XmlDocument doc = Windows.UI.Notifications.TileUpdateManager.GetTemplateContent(Windows.UI.Notifications.TileTemplateType.TileSquare150x150Text02);
                var nodes = doc.SelectNodes("tile/visual/binding/text");
                if (nodes.Count >= 2)
                {
                    // 修改XML值
                    ((XmlElement)nodes[0]).InnerText = items[0];
                    ((XmlElement)nodes[1]).InnerText = items[1];
                }
                // 更新磁贴
                TileUpdateManager.CreateTileUpdaterForApplication().Update(new TileNotification(doc));

                // 顺便也发一下Toast通知
                XmlDocument doctoast = ToastNotificationManager.GetTemplateContent(ToastTemplateType.ToastText02);
                var txtnodes = doctoast.GetElementsByTagName("text");
                if (txtnodes.Count > 1)
                {
                    // 修改XML值
                    ((XmlElement)txtnodes[0]).InnerText = items[0];
                    ((XmlElement)txtnodes[1]).InnerText = items[1];
                }
                // 发送Toast通知
                ToastNotificationManager.CreateToastNotifier().Show(new ToastNotification(doctoast));
            }
      
}


当Run方法被调用时,会把一个实现了IBackgroundTaskInstance接口的对象实例通过参数传递进来,它表示当前正在执行的后台任务的实例。接着通过访问taskInstance.TriggerDetails属性获得一个跟触发当前后台任务相关联的对象。

我们这个后台任务是由于RAW通知到达而触发的,因此,TriggerDetails属性所引用的对象就是一个RawNotification实例,再经过Content属性就能得到RAW通知的内容了。

我测试的时候,是用一个“|”符号把标题和正文分符开来,因此应用程序在收到通知后要对内容字符进行分割处理,以得到标题和正文。

最后,把收到的内容保存到本地存储中,并向用户发送Toast提醒,同时更新磁贴。

 

4、回到WP应用项目,添加对刚才的后台任务的引用。

5、打开清单文件,切换到“声明”选项卡,添加一个后台任务,触发器为“推送通知”,入口点为刚才定义的后台类的类名,包含命名空间名字。如下图。

 

6、修改清单文件仅仅是允许某个后台任务,要让后台任务真正运行起来,还需要在代码中进行注册。

            string taskName = "back_notifi"; //后台任务名称
            string entryPoint = "RawNotificationBackgroundTask.NotifiBackTask"; //入口点
            // 检查是否许后台任务
            var result = await BackgroundExecutionManager.RequestAccessAsync();
            if (result == BackgroundAccessStatus.AllowedMayUseActiveRealTimeConnectivity)
            {
                // 检查是否已经注册后台任务
                var task = BackgroundTaskRegistration.AllTasks.Values.FirstOrDefault((t) => t.Name == taskName);
                // 如果未注册,则进行注册
                if (task == null)
                {
                    BackgroundTaskBuilder tb = new BackgroundTaskBuilder();
                    tb.TaskEntryPoint = entryPoint;
                    tb.Name = taskName;
                    // 触发器为推送通知触发器
                    tb.SetTrigger(new PushNotificationTrigger());
                    // 运行条件为网络可用
                    tb.AddCondition(new SystemCondition(SystemConditionType.InternetAvailable));
                    // 注册
                    tb.Register();
                }
            }

var task = BackgroundTaskRegistration.AllTasks.Values.FirstOrDefault((t) => t.Name == taskName);一行代码是检查一下后台任务是否已经注册,如果已经注册了,就不要再注册了,后台任务的名字必须是唯一的,不能与其他后台任务重复。

 

记得:要将清单中的标识与应用商店中的信息同步,请参考上一篇文章。

 

7、现在,以管理员的身份运行我们前面开发的测试服务端,通知类型选择“自定义”。

 

 

发送通知后,在手机上就会收到相应的通知,请看下面的美图。

 

 

 

示例代码下载:https://files.cnblogs.com/tcjiaan/RawNotificationWPClientApp.rar

 

posted @ 2014-08-13 17:31  东邪独孤  阅读(1461)  评论(11编辑  收藏  举报