背水一战 Windows 10 (121) - 后台任务: 推送通知
作者:webabcd
介绍
背水一战 Windows 10 之 后台任务
- 推送通知
示例
演示如何接收推送通知
/WebApi/PushNotificationController.cs
/*
* 演示如何向 app 推送通知
* 由于本例没有上商店,所以本例是无法演示的,需要看演示效果的话运行一下自己写的“打字通”的 /TypingGame/PushNotification/Sample.xaml,然后用其生成的 channel 地址在 /WebApi/Controllers/PushNotificationController.cs 推送通知
*
*
* 注:
* 关于推送通知服务请求和响应头的详细说明参见:https://msdn.microsoft.com/zh-cn/library/windows/apps/hh465435.aspx
*/ using System;
using System.IO;
using System.Net;
using System.Net.Http;
using System.Text;
using System.Web.Http;
using System.Runtime.Serialization;
using System.Runtime.Serialization.Json;
using System.Threading.Tasks; namespace WebApi.Controllers
{
public class PushNotificationController : ApiController
{
[HttpGet]
public async Task<HttpResponseMessage> Get()
{
// 向某个 app 推送通知的 channel 地址(通过客户端的 PushNotificationChannelManager.CreatePushNotificationChannelForApplicationAsync() 方法生成)
string notifyUrl = "https://hk2.notify.windows.com/?token=AwYAAAANZzLsCX%2fl1aavCSQhi%2fdEBO5wdplj7S4a3o4t8wGSGo05hRE6VC7xEMCFtGDrVuV%2f9J2ItuVri1F4Z0YNjtbuCqf6LQvov0UE3%2flD1sP1poaS1Qp30UQ%2fWVKVUBCjPFuWFLuyuq7UuuTvJcCcQzey"; // 在商店后台的 dashboard 中的“Package SID”中可以找到此值(可以在 https://apps.dev.microsoft.com/ 中查找)
string sid = "ms-app://s-1-15-2-1792688850-3283391166-**********-**********-**********-1809961044-230289451";
// 在商店后台的 dashboard 中的“Application Secrets”中可以找到此值(可以在 https://apps.dev.microsoft.com/ 中查找)
string secret = "koghs4zz*************S+5sEoqoNb4"; OAuthHelper oAuth = new OAuthHelper();
OAuthToken token = oAuth.GetAccessToken(secret, sid); HttpResponseMessage result = null; try
{
HttpClient httpClient = new HttpClient();
HttpRequestMessage request = new HttpRequestMessage(HttpMethod.Post, notifyUrl); // 推送消息的类型:wns/toast | wns/badge | wns/tile | wns/raw
request.Headers.Add("X-WNS-Type", "wns/toast");
// 设置 access-token
request.Headers.Add("Authorization", String.Format("Bearer {0}", token.AccessToken)); // 需要推送的 toast 通知的内容
string toastXml = $@"
<toast activationType='foreground' launch='PushNotification-Toast-Arguments'>
<visual>
<binding template='ToastGeneric'>
<text>toast - title</text>
<text>toast - content {DateTime.Now.ToString("mm:ss")}</text>
</binding>
</visual>
</toast>"; // toast, tile, badge 为 text/xml; raw 为 application/octet-stream
request.Content = new StringContent(toastXml, Encoding.UTF8, "text/xml"); HttpResponseMessage response = await httpClient.SendAsync(request);
/*
* 响应代码说明
* 200 - OK,WNS 已接收到通知
* 400 - 错误的请求
* 401 - 未授权,token 可能无效
* 403 - 已禁止,manifest 中的 identity 可能不对
* 404 - 未找到
* 405 - 方法不允许
* 406 - 无法接受
* 410 - 不存在,信道不存在或过期
* 413 - 请求实体太大,限制为 5000 字节
* 500 - 内部服务器错误
* 503 - 服务不可用
*/
HttpStatusCode statusCode = response.StatusCode;
result = new HttpResponseMessage
{
Content = new StringContent(statusCode.ToString(), Encoding.UTF8, "text/html")
};
}
catch (Exception ex)
{
result = new HttpResponseMessage
{
Content = new StringContent(ex.ToString(), Encoding.UTF8, "text/html"),
StatusCode = HttpStatusCode.InternalServerError
};
} return result;
}
} /*
* 用于反序列化从 https://login.live.com/accesstoken.srf 获取到的结果
*/
[DataContract]
public class OAuthToken
{
[DataMember(Name = "access_token")]
public string AccessToken { get; set; }
[DataMember(Name = "token_type")]
public string TokenType { get; set; }
} /*
* 用于从 https://login.live.com/accesstoken.srf 做 OAuth 验证的帮助类
*/
public class OAuthHelper
{
/// <summary>
/// 获取 https://login.live.com/accesstoken.srf 的 OAuth 验证的 access-token
/// </summary>
/// <param name="secret">在商店后台的 dashboard 中的“Application Secrets”中可以找到此值(可以在 https://apps.dev.microsoft.com/ 中查找)</param>
/// <param name="sid">在商店后台的 dashboard 中的“Package SID”中可以找到此值(可以在 https://apps.dev.microsoft.com/ 中查找)</param>
/// <returns></returns>
public OAuthToken GetAccessToken(string secret, string sid)
{
var urlEncodedSecret = UrlEncode(secret);
var urlEncodedSid = UrlEncode(sid);
var body = String.Format("grant_type=client_credentials&client_id={0}&client_secret={1}&scope=notify.windows.com",
urlEncodedSid,
urlEncodedSecret); string response;
using (WebClient client = new WebClient())
{
client.Headers.Add("Content-Type", "application/x-www-form-urlencoded");
response = client.UploadString("https://login.live.com/accesstoken.srf", body);
}
return GetOAuthTokenFromJson(response);
} private OAuthToken GetOAuthTokenFromJson(string jsonString)
{
using (var ms = new MemoryStream(Encoding.Unicode.GetBytes(jsonString)))
{
var ser = new DataContractJsonSerializer(typeof(OAuthToken));
var oAuthToken = (OAuthToken)ser.ReadObject(ms);
return oAuthToken;
}
} private static string UrlEncode(string str)
{
StringBuilder sb = new StringBuilder();
byte[] byStr = System.Text.Encoding.UTF8.GetBytes(str);
for (int i = ; i < byStr.Length; i++)
{
sb.Append(@"%" + Convert.ToString(byStr[i], ));
} return (sb.ToString());
}
}
}
BackgroundTask/PushNotification.xaml
<Page
x:Class="Windows10.BackgroundTask.PushNotification"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:local="using:Windows10.BackgroundTask"
xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
mc:Ignorable="d"> <Grid Background="Transparent">
<StackPanel Margin="10 0 10 10"> <TextBlock Name="lblMsg" Margin="5" /> <Button Name="btnCreateChannel" Content="create the channel" Margin="5" Click="btnCreateChannel_Click" /> <TextBox Name="txtUri" Margin="5" /> <TextBlock Margin="5">
<Run>1、应用为推送通知通道向通知客户端平台发送请求。</Run>
<LineBreak />
<Run>2、通知客户端平台要求 WNS 创建通知通道。此通道以统一资源标识符 (URI) 的形式返回到调用设备。</Run>
<LineBreak />
<Run>3、通知通道 URI 由 Windows 返回到应用。</Run>
<LineBreak />
<Run>4、你的应用将 URI 发送到你自己的云服务。此回调机制是你自己的应用和你自己的服务之间的接口。使用安全的 Web 标准实现此回调是你的责任。</Run>
<LineBreak />
<Run>5、当你的云服务有要发送的更新时,它使用通道 URI 通知 WNS。通过安全套接字层 (SSL) 发送 TTP POST 请求(包括通知负载)来执行此操作。此步骤需要身份验证。</Run>
<LineBreak />
<Run>6、WNS 接收请求,并将通知路由到相应的设备。</Run>
</TextBlock>
<Image Source="wns.png" Margin="5" HorizontalAlignment="Left" Width="800" /> </StackPanel>
</Grid> </Page>
BackgroundTask/PushNotification.xaml.cs
/*
* 演示如何接收推送通知
* 由于本例没有上商店,所以本例是无法演示的,需要看演示效果的话运行一下自己写的“打字通”的 /TypingGame/PushNotification/Sample.xaml,然后用其生成的 channel 地址在 /WebApi/Controllers/PushNotificationController.cs 推送通知
*
*
* 注:
* 1、在商店后台的 dashboard 中找到你的 app 的“包名”和“发布者”并替换你的 Package.appxmanifest 中的相关节点,类似如下
* <Identity Name="10437webabcd.**********E91" Publisher="CN=27514DEC-****-****-****-F956384483D0" Version="1.0.0.0" />
* 也可以直接访问 https://apps.dev.microsoft.com/ 来查找这些信息
* 最简单也是推荐的做法是:“选中项目”->“右键”->“应用商店”->“将应用程序与应用商店关联”,按提示操作后会自动将商店信息同步到你的项目中
* 2、需要在 Package.appxmanifest 中增加后台任务声明,并勾选“推送通知”(经测试发现不做这一步也可以,但是为了保险还是加上吧)
* 3、每次新建的 channel 有效期为 30 天
*
*
* 另:
* WNS - Windows Push Notification Service
* 推送通知的服务端参见:/WebApi/Controllers/PushNotificationController.cs
*/ using System;
using Windows.Networking.PushNotifications;
using Windows.UI.Notifications;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls; namespace Windows10.BackgroundTask
{
public sealed partial class PushNotification : Page
{
public PushNotification()
{
this.InitializeComponent();
} private async void btnCreateChannel_Click(object sender, RoutedEventArgs e)
{
// 创建一个推送通知信道,每个新建的 channel 有效期为 30 天,所以建议每次进入 app 后都重新建一个 channel(如果两次创建的间隔时间较短的话,则会复用之前的 channel 地址)
PushNotificationChannel channel = await PushNotificationChannelManager.CreatePushNotificationChannelForApplicationAsync();
// 接收到通知后所触发的事件
channel.PushNotificationReceived += channel_PushNotificationReceived; // channel.Close(); // 关闭 channel
// channel.ExpirationTime; // channel 的过期时间,此时间过后 channel 则失效 // channel 的 uri 地址,服务端通过此 uri 向此 app 推送通知
txtUri.Text = channel.Uri.ToString();
} void channel_PushNotificationReceived(PushNotificationChannel sender, PushNotificationReceivedEventArgs args)
{
switch (args.NotificationType)
{
case PushNotificationType.Badge: // badge 通知
BadgeUpdateManager.CreateBadgeUpdaterForApplication().Update(args.BadgeNotification);
break;
case PushNotificationType.Raw: // raw 通知
// 当收到推送的 raw 通知时,如果 app 在锁屏,则可以触发后台任务以执行相关的逻辑(PushNotificationTrigger)
string msg = args.RawNotification.Content;
break;
case PushNotificationType.Tile: // tile 通知
TileUpdateManager.CreateTileUpdaterForApplication().Update(args.TileNotification);
break;
case PushNotificationType.Toast: // toast 通知
ToastNotificationManager.CreateToastNotifier().Show(args.ToastNotification);
break;
default:
break;
} args.Cancel = true;
}
}
}
OK
[源码下载]