【WP 8.1开发】推送通知测试服务端程序_.NET_编程开发_程序员俱乐部

所谓推送通知，用老爷爷都能听懂的话说，就是：

1、我的服务器将通知内容发送到微软的通知服务器，再由通知服务器帮我转发消息。

2、那么，微软的推送服务器是如何知道我的服务器要发消息给哪台手机呢？手机客户端应用程序在创建推送通道时，微软的通知服务器会为手机分配一个URL，我的服务器只要知道这个URL就可以向指定的手机发送消息。所以，手机客户端必须通过网络把获取到的手机URL发给我的服务器，方法很多，如使用Socket、HTTP提交、Web服务、WCF等都可以。

要测试推送通知，可以通过WP 8.1的模拟器的模拟通知功能来实现，但是，这个模拟通知功能目前不太稳定，为啥不稳定呢？我发现可能与Hyper-V的虚拟交换机有关，如果人品好的时候，就可以顺利完成模拟通知；如果哪天人品值波动，就有可能出现错误。

话又说回来，模拟终究是模拟，假的！如果不进行真实的推送测试，说不定你的应用给用户使用时发生意外情况，那就非同一般的痛苦了。对于手机用于接收通知的URL，在调试的时候，可以通过DeBug类输出，然后我们像厦大的教授写论文一样，直接按Ctrl + C，再在服务端Ctrl+V一下就行了。

调试归调试，在实际运作中，应用运行在用户的手机上，你不可能拿每个用户的爱机来debug一下，然后再取得URL的，显然这种做法只能在神话故事才可行，在人间是行不通的。因而我们在开发WP应用时，一定要注意通过网络把手机的通道URL发送到我们的服务器，有了URL才能向某手机发送消息。这就好像你得知道妹子的手机号码，才能向妹子发短信一样，当然，现在人们都用微信来找妹子了。

 为了能学会如何使用WP的推送通知，我们首先得有一个服务器，当然不是叫大家去买一台服务器，我们自己动手，写一个测试服务器就行了。

要实现推送，我们必须拥有开发者帐号，至于如何获得，呵呵，方法多着。你可以付款去购买一个，这样的开发者帐号限制较少，可以提交桌面应用；如果你是学生当然首选学生帐号；如果你既不是学生也不想花钱，也是可以的，微软做了一个WP App Studio，是web版的开发工具，不过大家莫笑，这个是给不会编程的人或小孩子玩的，说不得专业。但是，注凹App Studio是免费的，这是重点。至于如何注册，我相信各位都玩过微博、QQ、人人网等东东了，不用我介绍了，无非是填资料，下一步，下一步，完成。如果你不打算在应用商店发布应用，而只是想玩一下，或学习一下，付款信息可以不填，不管它。

创建应用

有了开发者帐号后，我们要在商店中先创建一个应用，应用信息随便填就可以了。如下图，我创建了一个名为“示例应用”的牛X应用程序。

点击应用，进入应用描述页，点击“详细信息”，查看应用的详细信息。

向下滚动页面，找到“Windows推送通知（WNS）”，然后点击超链接进入。

之后会看到这一系列东东。

程序包SID：发送通知的服务器（即我的服务器）在申请Access Token时需要这个，做过微博API的调用的朋友肯定不会陌生，我们在调用微博API前必须得到授权，并换取一个AccessToken，然后我们用这个Token来调用API，相当于一个门卡，通过它可以进入旅店房间。SID除了在申请token时使用，还要把它写到WP应用的清单文件中，即“包名”，两者必须匹配才能允许发送推送消息。

应用程序标识：是应用程序清单文件（实质是XML）中的Identity节点，一定要与“仪表盘”中显示的一致。

客户端ID：完成推送暂时用不到它。

客户端密钥：我的服务器要申请Access Token时需要用到，即我们调用微博API时用到的Secret key，这个一般不要对外公开，开发者自己知道就可以了，不然别人也可以冒充你来发送通知了。

在以上各字段的数据中，要实现推送通知，我们要用到的有：SID、应用程序标识、客户端密钥这三个东东。

开发者身份验证

和微博API调用相似，我们要先验证自己的身份，获得一个access token，才能向指定的手机发送通知，以下是向WNS服务器发送的HTTPS请求的示例。

POST /accesstoken.srf HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Host: https://login.live.com
Content-Length: 211
 
grant_type=client_credentials&client_id={SID}&client_secret={客户端密钥}&scope=notify.windows.com

从中，我们看到该请求有以下几个特点：
1、使用HTTPS方案，地址为https://login.live.com/accesstoken.srf；

2、提交方式为POST；

3、内容格式为application/x-www-form-urlencoded；

4、POST的内容包括四个值：grant_type的值固定为client_credentials，这个不用讲，照抄就行；

注意client_id不是“客户端标识”，应该填上SID，不要填错了。client_secret填上“客户端密钥”。

最后那个scope字段也是固定值，照抄就行了，值为notify.windows.com。

发送POST验证成功后，会返回以下内容：

HTTP/1.1 200 OK   
Cache-Control: no-store
Content-Length: 422
Content-Type: application/json
 
{
    "access_token":"EgAcAQMAAAAALYAAY/c+Huwi3Fv4Ck10UrKNmtxRO6Njk2MgA=", 
    "token_type":"bearer"
}

返回的JSON中，access_token的值就是申请的access token的值了，我们就是用这个来传送通知的。

发送通知

在拿到token后，我们就可以用它来发送通知了。如：

POST https://db3.notify.windows.com/?token=AgUAAADCQmTg7OMlCg%2fK0K8rBPcBqHuy%2b1rTSNPMuIzF6BtvpRdT7DM4j%2fs%2bNNm8z5l1QKZMtyjByKW5uXqb9V7hIAeA3i8FoKR%2f49ZnGgyUkAhzix%2fuSuasL3jalk7562F4Bpw%3d HTTP/1.1
Authorization: Bearer EgAaAQMAAAAEgAAACoAAPzCGedIbQb9vRfPF2Lxy3K//QZB79mLTgK
X-WNS-RequestForStatus: true
X-WNS-Type: wns/toast
Content-Type: text/xml
Host: db3.notify.windows.com
Content-Length: 196

<toast launch="">
  <visual lang="en-US">
    <binding template="ToastImageAndText01">
      <image id="1" src="World" />
      <text id="1">Hello</text>
    </binding>
  </visual>
</toast>

上面所示的请求中，目标URL就是手机客户端注册的通过URL，这就是为什么客户端程序要把URL发送给服务器的原因，如果服务器不知道通道URL，就无法知晓要把消息发送给哪一台手机了。

 通知的内容都是以XML的形式表示的（RAW通知除外，RAW是自定义通知），关于这些XML模板，参考文档上有介绍，而且我们也可以通过API来得到这些模板，这个现在先不说，后面我们会提到。注意几个HTTP头。

Authorization——传递服务器所获取到的access token，格式为“Bearer <token>”，Bearer与token之间有空格。

X-WNS-Type——通知的类型。wns/toast表示发送Toast通知；wns/tile表示磁贴通知；wns/badge表示锁屏通知……

其他标头可以参考这里：http://msdn.microsoft.com/zh-cn/library/windows/apps/xaml/hh868245.aspx#pncodes_x_wns_type

开发测试服务器

现在，估计大家对推送通知的过程已有了解，趁热打铁、付诸实践是成为编程高手的重要因素，因此，为了成为编程高手，我们接下来马上开工，开发一个可以用于测试推送通的Win Forms程序。

1、以管理员身份运行VS 2013 Express for Desktop。我一直很喜欢Express版本，虽然我有MSDN订阅，但我还是用Express版，它比较简洁，但已经集成了VS的核心功能，用来做商业开发都没问题，最重要的是这家伙是免费的。偏偏有些垃圾公司喜欢装逼，开发个破产品还要弄个旗舰版，而且许多功能也用不上。为什么要以管理员身份运行呢？因为我计划用WCF服务来接收客户端APP发来的URL。

2、新建一个Windows窗体应用程序，我就不建WPF了，WinForm大家熟悉一点，用最成熟的方式有时候很爽。

3、我们首先完成的功能是如何根据不同通知生成XML模板。做过RT应用开发的朋友肯定会记得，在Windows.UI.Notifications命名空间下，使用ToastNotificationManager类或TileUpdateManager类，或BadgeUpdateManager类的GetTemplateContent方法，可以返回指定通知的XML模板。可是，我们这里建的是桌面应用，那有没有可能，在桌面应用中调用RT的API呢？告诉你，是可以的，但前题是你用的是Win 8.1系统。

来吧，咱们试试看。首先打开VS的“解决方案资源管理器”，选中刚才创建的桌面项目，右击鼠标，从快捷菜单中选择“卸载项目”，如下图。

同样，在项目节点上右击，从菜单中选择“编辑 <项目名>”。

这时候，就会用XML编辑器打开项目文件，找到第一个PropertyGroup节点，注意是第一个，不要找到其他去了，在第一个PropertyGroup节点下，加入一个TargetPlatformVersion节点，版本号为8.1。

    <TargetPlatformVersion>8.1</TargetPlatformVersion>

然后保存并关闭文件。重新加载项目，在添加引用对话框中，就会看到Windows 8.1的选项卡了。

但是，这里列出的“Windows”程序集不是WP8.1的，通过下面的浏览按钮，找到C:\Program Files (x86)\Windows Phone Kits\8.1\References\CommonConfiguration\Neutral目录下的Windows.winmd文件，这才是WP 8.1的运行时API所在的程序集。另外，为了能正常访问，还要添加以下程序集：

C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.5\Facades\System.Runtime.dll

C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.5\Facades\System.Runtime.InteropServices.dll

C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETCore\v4.5.1\System.Runtime.WindowsRuntime.dll

其中，System.Runtime.InteropServices.dll不一定要添加，但建议添加，因为如果不加，个别API无法附加事件处理程序。

现在，我们这个WinForm程序就可以访问WP8.1中的API了。

我正是要通过这种方法，把所有的通知模板的XML文档都读出来。

下面是部分代码：

        private Type enumType = null;

        void cmbNotifiType_SelectedIndexChanged(object sender, EventArgs e)
        {
            ComboBox cb = sender as ComboBox;
            if (cb.SelectedIndex == -1) return;

            string[] enumNames = null;
            // 判断通知类型
            switch (cb.SelectedIndex)
            {
                case 0: //Toast通知
                    enumType = typeof(ToastTemplateType);
                    break;
                case 1: //磁贴通知
                    enumType = typeof(TileTemplateType);
                    break;
                case 2: //锁屏通知
                    enumType = typeof(BadgeTemplateType);
                    break;
                case 3: //自定义通知
                    enumType = null; //无
                    break;
            }
            enumNames = enumType == null ? null : Enum.GetNames(this.enumType);
            cmbTemplate.DataSource = enumNames;
        }

        void cmbTemplate_SelectedIndexChanged(object sender, EventArgs e)
        {
            if (cmbTemplate.SelectedIndex == -1)
            {
                return;
            }
            // 显示内容
            if (enumType == typeof(ToastTemplateType))
            {
                ToastTemplateType tem = (ToastTemplateType)Enum.Parse(enumType, cmbTemplate.SelectedItem as string);
                XmlDocument doc = ToastNotificationManager.GetTemplateContent(tem);
                txtContent.Text = doc.GetXml();
            }
            else if (enumType == typeof(TileTemplateType))
            {
                TileTemplateType tem = (TileTemplateType)Enum.Parse(enumType, cmbTemplate.SelectedItem as string);
                XmlDocument doc = TileUpdateManager.GetTemplateContent(tem);
                txtContent.Text = doc.GetXml();
            }
            else if (enumType == typeof(BadgeTemplateType))
            {
                BadgeTemplateType tem = (BadgeTemplateType)Enum.Parse(enumType, cmbTemplate.SelectedItem as string);
                XmlDocument doc = BadgeUpdateManager.GetTemplateContent(tem);
                txtContent.Text = doc.GetXml();
            }
            else
            {
                txtContent.Text = string.Empty;
            }
        }

通过Enum.GetNames方法可以把一个枚举类型在所有值的名字取出，以字符串数组的形式返回，使用这思路，我们可以将ToastTemplateType、TileTemplateType、BadgeTemplateType几个枚举的值的名称全部读出，显示在下拉列表框（ComboBox）中，当我们在界面上选择一个值时，又通过Enum.Parse方法从枚举值的名称生成枚举实例。最后可以通过GetTemplateContent方法来获取XML文档了。

这样做的好处在于，我们不用手动去准备XML文档。

4、打开Program.cs文件，在Program类中添加用于接收URL的代码。

    static class Program
    {
        /// <summary>
        /// 应用程序的主入口点。
        /// </summary>
        [STAThread]
        static void Main()
        {
            HttpListener listener = new HttpListener();
            listener.Prefixes.Add("http://+:85/svr/");
            try
            {
                listener.Start();
                listener.BeginGetContext(new AsyncCallback(OnGetAcceptCallback), listener);
            }
            catch { }

            /*  WinForm项目生成的代码  */

            try
            {
                listener.Stop();
            }
            catch { }
        }

        private static void OnGetAcceptCallback(IAsyncResult ar)
        {
            HttpListener listener = (HttpListener)ar.AsyncState;

            try
            {
                var context = listener.EndGetContext(ar);
                string url;
                using (var stream = context.Request.InputStream)
                {
                    long len = context.Request.ContentLength64;
                    byte[] buffer = new byte[len];
                    stream.Read(buffer, 0, buffer.Length);
                    url = System.Text.Encoding.UTF8.GetString(buffer);
                }
                if (OnGetUrl != null)
                {
                    OnGetUrl(url);
                }
            }
            catch { }

            try
            {
                listener.BeginGetContext(new AsyncCallback(OnGetAcceptCallback), listener);
            }
            catch { }
        }

        // 当收到WP客户端应用发来的URL时会触发该事件
        public static event Action<string> OnGetUrl;
    }

这里我选用HttpListener对象来监听HTTP请求，注意如果你用真实手机发送时，要配置一下防火墙，如果你嫌麻烦，就暂时把防火墙关了。地址http://+:85/svr/表示监听本机所有地址，如http://192.168.1.50:85/svr/，端口号是85，当然你可以根据实际情况自己改一下。

Program类中还定义了一个静态事件OnGetUrl，当接收到手机发来的URL后会引发这个事件，我们在主窗口中可以通过处理该事件来在用户界面上显示URL。如

            this.Load += (s1, a1) =>
            {
                Program.OnGetUrl += GetUrlService_OnUrlGot;
            };
            this.FormClosed += (s2, a2) =>
            {
                Program.OnGetUrl -= GetUrlService_OnUrlGot;
            };

            ……

        void GetUrlService_OnUrlGot(string url)
        {
            BeginInvoke(new Action(() =>
            {
                if (cmbURLs.FindString(url) < 0)
                {
                    cmbURLs.Items.Add(url);
                }
            }));
        }

当收到URL后，将URL放进一个ComboBox控件的下拉列表中。

5、下面要完成access token验证功能的实现。

            // 发起请求
            using (HttpClient client = new HttpClient())
            {
                // 准备要提交的数据
                IDictionary<string, string> formdata = new Dictionary<string, string>()
                {
                    { "grant_type", "client_credentials" }, /* 固定值 */
                    { "client_id", txtSID.Text.Trim() }, /* SID */
                    { "client_secret", txtSecret.Text.Trim() }, /* 客户端密钥，勿公开 */
                    { "scope", "notify.windows.com" } /* 固定值 */
                };
                FormUrlEncodedContent content = new FormUrlEncodedContent(formdata.AsEnumerable());
                // POST，并获取返回数据
                btnVertify.Enabled = false;
                HttpResponseMessage resp = await client.PostAsync("https://login.live.com/accesstoken.srf", content);
                btnVertify.Enabled = true;
                if (resp.StatusCode == HttpStatusCode.OK) //成功
                {
                    System.IO.Stream streamIn = await resp.Content.ReadAsStreamAsync();
                    // 反序列化，得到access token
                    DataContractJsonSerializer js = new DataContractJsonSerializer(typeof(OAuth2Data));
                    OAuth2Data odata = (OAuth2Data)js.ReadObject(streamIn);
                    streamIn.Close();
                    if (odata != null)
                    {
                        // 显示token
                        txtToken.Text = odata.AccessToken;
                    }
                }
                else
                {
                    StringBuilder sb = new StringBuilder();
                    foreach (var hd in resp.Headers)
                    {
                        sb.AppendLine(hd.Key + " : " + string.Join(",", hd.Value.ToArray()));
                    }
                    MessageBox.Show(string.Format("验证失败，错误码：{0}。\n{1}", (int)resp.StatusCode, sb.ToString()));
                }

前面说过，申请token需要向服务器POST格式为application/x-www-form-urlencoded的数据。上面代码中我用的是比较智能的HttpClient类，它可以很轻松地向服务器发送Content，此处应选用FormUrlEncodedContent类。注意这个类比较智能，它会自动帮我们做URL编码处理，因此我们放进去的内容是不需要手动编码的，如果将已编码的内容放进去，会导致重复编码，导致意外错误，token申请失败。
Access Token是以一个JSON对象的形式出现的。还记得吗，上文中我们说过的。如何处理服务器返回的JSON呢？最简单的方法是使用反序列化，直接把JSON对象反序列化为一个类实例就好了。

用来封装token的类定义如下。

    [DataContract]
    public class OAuth2Data
    {
        [DataMember(Name="access_token")]
        public string AccessToken { get; set; }
        [DataMember(Name = "token_type")]
        public string TokenType { get; set; }
    }

DataMember特性的Name所指定的值一定要与JSON数据的字段名匹配，否则反序列化时无法识别。

6、接下来完成发送通知的功能。

            string wns_type_header = ""; //推送类型
            string content_type = "text/xml"; //内容格式标头
            if (enumType == typeof(ToastTemplateType)) //toast
            {
                wns_type_header = "wns/toast";
            }
            else if (enumType == typeof(TileTemplateType)) //tile
            {
                wns_type_header = "wns/tile";
            }
            else if (enumType == typeof(BadgeTemplateType)) //badge
            {
                wns_type_header = "wns/badge";
            }
            else
            {
                wns_type_header = "wns/raw";
                content_type = "application/octet-stream";
            }
            // 验证标头
            string author_header = string.Format("Bearer {0}", txtToken.Text);

            HttpWebRequest request = (HttpWebRequest)WebRequest.Create(cmbURLs.Text);
            // 添加必要标头
            request.ContentType = content_type;
            request.Headers.Add("X-WNS-Type", wns_type_header);
            request.Headers.Add("Authorization", author_header);
            // 添加可选标头
            if (ckbSuppressPop.Checked && enumType == typeof(ToastTemplateType))
            {
                request.Headers.Add("X-WNS-SuppressPopup", "true");
            }
            if (ckbWns_Tag.Checked && string.IsNullOrWhiteSpace(txtWNS_Tag.Text) == false)
            {
                request.Headers.Add("X-WNS-Tag", txtWNS_Tag.Text);
            }
            if (ckbWns_Group.Checked && string.IsNullOrWhiteSpace(txtWns_Group.Text) == false)
            {
                request.Headers.Add("X-WNS-Group", txtWns_Group.Text);
            }

            // POST
            request.Method = "POST";
            // 内容
            byte[] data = Encoding.UTF8.GetBytes(txtContent.Text);
            //request.ContentLength = data.Length;
            // 写入
            using (var streamout = request.GetRequestStream())
            {
                streamout.Write(data, 0, data.Length);
            }

            // 发起请求
            HttpWebResponse response = null;
            try
            {
                response = (HttpWebResponse)request.GetResponse();
                if (response.StatusCode == HttpStatusCode.OK)
                {
                    MessageBox.Show("发送成功。");
                }
                else
                {
                    MessageBox.Show("发送失败。");
                }
            }
            catch (WebException webex)
            {
                ……
            }

通知的正文是XML文档（RAW通知除外），以下几个标头是必须的：
Authorization：验证后获取的token就通过该头来传递，格式为Bearer <access token>，注意Bearer与Token之间有个空格，之个access token就是我们通过验证后获取的Token。

X-WNS-Type：通知的类型。如果是Toast通知就wns/toast，如果是磁贴通知就wns/tile，反正照着MSDN的文档套就行了，就像抄袭论文一样轻松。

ContentType：基本上都是text/xml，只有RAW通知使用application/octet-stream

然后是一些可选的标头：

X-WNS-Tag和X-WNS-Group可以一起用，tag相当于通知的id，Toast通知比较明显，如果我发送了一条tag为a的Toast通知，然后再发一条tag为b的Toast通知，就算a和b的内容完全一样，但由于tag不同，它们在手机上会显示为两条消息。

如果第一条Toast的tag为c，然后再发一条tag也为c的Toast通知，那么，第二条Toast会替换掉第一条Toast，也就是说始终在手机上只会提示一条通知。

如果用上了X-WNS-Group，就可以对Tag进行分组，同一组下的tag必须唯一，但不同组之间可以存在相同的tag的通知，比如，组1中有一条通知的tag为f1，组2中有一条通知的tag为f1，虽然它们tag相同，但处于不同的组中，因此它们在手机上将显示为两条通知。

X-WNS-SuppressPopup标头是针对Toast通知而言的，如果为false，则Toast会弹出，如下图所示。

如果使用了X-WNS-SuppressPopup了标头，并设置为true，则Toast通知不会弹出来，而直接放进通知中心了。如下图

现在，这个用于测试推送通知的服务器已经完成了，我们可以用它来发送通知了。源码下载地址：http://files.cnblogs.com/tcjiaan/PushNotificationTestServer.rar

下一篇文章咱们来完成WP手机客户端程序，来接收推送通知。