WP7的Push Notifications

来源：互联网发布：百度软件中心手机编辑：程序博客网时间：2024/05/09 18:20

概觀

Windows Phone 中的 Microsoft Push Notification Service 向協力廠商開發人員提供了一個彈性，專注，而且持續的管道，使得開發人員可以從 web service 向移動應用程式發送資訊和更新。

過去移動應用程式需要經常主動去調查其相應的 Web 服務，以瞭解是否有任何等待處理的通知。這樣做雖然有效，但是會導致手機的無線設備頻繁打開，從而對電池續航時間帶來負面影響。使用 Push Notification 的方式取代主動調查，web service 能夠提醒應用程式獲取所需要的重要更新。

圖1
Push Notifications

當一個 Web service 有資訊要發送到應用程式，它先發送一個通知到 Push Notification Service，該服務隨後將通知路由到應用程式。根據 Push Notification 的格式和裝載量，資訊作為原始資料傳遞到應用程式，應用程式的標題明顯地更新或顯示一個 Toast 通知。然後如果需要的話應用程式可以使用自己的協定聯繫 web service 以獲取更新。

Push Notification Service 在 Push Notification 發送後向你的 web service 發送一個回應碼。然而，Push Notification Service 不能為你的推送提醒是否確實成功傳遞到應用程式提供端的確認。瞭解更多資訊，請參考Push Notification Service Response Codes for Windows Phone。

本實驗包括了 Push Notification，並介紹了 Silverlight 中的 HTTP 服務的使用。在這個實驗中，您將建立透過 Push Notification ServicePush Notification 服務發送消息必需的伺服器端的邏輯，你也將建立一個簡單的 Windows Phone 7 應用程式，作為用戶端接收這種通知。用戶端應用接收天氣狀況更新，伺服器端業務應用 (簡單的WPF 應用程式) 會透過 Push Notification Services 發送天氣提醒到已註冊的用戶端應用程式，一旦用戶端應用程式接收到這種提醒，它會顯示接收到的資訊。

目標

完成本實驗你將：

熟悉 Windows Phone 7 應用程式的通訊能力。
熟悉 Push Notification 的概念和他們在手機上啟用後的行為。
理解 Push Notification 在手機端和雲端如何工作。
使用手機的 Push Notification 服務建立一個訂閱 Tokens (tiles)，Toasts 和 RAW Push Notification。
使用 web 用戶端來申請 Push Notifications。
使用網路狀態來顯示當前的手機的網路狀態。
建立一個 SL 應用程式訂閱 Push Notification 服務 (包括 token 和 toast)
- 執行過程中處理 push 事件 (token，toast，和 raw) 。
- 在 shell 上顯示 token 和 toast。

前置條件

以下是完成本次實驗所必須的條件：

用於 Windows Phone 的 Microsoft Visual Studio 2010 Express 或者 Microsoft Visual Studio 2010。
Windows Phone 開發工具。

說明：所有的 Windows Phone 開發工具都可以從以下網址打包下載 http://developer.windowsphone.com

安裝程式碼片段

為了方便起見，本次實驗所使用的大部分程式碼都封裝為 Visual Studio 的程式碼片段提供。

若要安裝程式碼片段：

執行本實驗 Source \ Setup 資料夾下的 .vsi 安裝程式。

注釋：如果你在執行程式碼片段的安裝程式時遇到問題，你可以透過拷貝Source \ Setup \ CodeSnippets 資料夾下的所有 .snippet 檔到目錄：

My Documents \ Visual Studio 2010 \ Code Snippets \ Visual C# \ My Code Snippets

使用程式碼片段

透過程式碼片段，你可以隨時獲取所有你想要的程式碼。本實驗手冊將會準確的告訴你什麼時候使用它們。例如：

圖2
使用 Visual Studio 程式碼片段把程式碼插入到你的專案裡

為了把程式碼片段添加到 Visual Studio 中，你只要把游標放在你想插入的程式碼上，開始輸入段落的名字 (沒有空格和連字型大小)，看到智慧感知的段落名稱，然後當你想要的段落名稱被選中時，敲擊 Tab 鍵兩次，程式碼將會被插入到游標的位置。

圖3
開始輸入程式碼片段落名稱

圖4
按 Tab 鍵來選取已選擇的段落

圖5
再次敲擊 Tab 鍵來展開程式碼片段

如果想使用滑鼠而不是鍵盤來插入程式碼片段，在你想插入程式碼片段的地方按右鍵，選擇 My Code Snippets 下面的InsertSnippet，然後從列表中挑選相關的程式碼片段。

想學習更多的 Visual Studio 程式碼片段，包括如何建立自己的程式碼片段，請參考

http://msdn.microsoft.com/en-us/library/ms165392.aspx。

練習

本實驗包括以下練習：

用於更新的 Windows Phone RAW Notifications 介紹。
用於提醒的 Toast 和 Tile Notifications 介紹。

完成實驗估計耗時：90分鐘。

Before you begin…

Push Notification 很像是目前手機電信業者所提供的簡訊服務，由微軟在雲端上提供一個 Microsoft Push Notification Services (MPN Services) 的雲端服務 (這個服務建構在 Windows Azure Platform 上)，而企業在自己的應用程式內實作一個服務，登錄並將訊息提交給 Push Notification Services，而位於 Windows Phone 內的用戶端應用程式在執行時開放一個雙向的 HTTP Channel 給 Push Notification Services，當 Push Notification Services 接到要發送給用戶端應用程式的訊息時，就會透過這個雙向的 HTTP Channel 發送訊息用戶端給應用程式。

在 Windows Phone Blog 上有數篇文章，有更多在 MPN Services 架構上使用上的探討：

Understanding Microsoft Push Notifications for Windows Phones
Understanding How Microsoft Push Notification Works – Part 2
Using Push Notification from Your Windows Phone Application

練習 1：用於更新的 Windows Phone RAW Notifications 介紹

本部分我們將打開 starter solution 並：

實現伺服器端通知和註冊服務。
建立Windows Phone 7 用戶端應用程式。
建立notification 通道和訂閱通道事件。
接收並處理來自 Push Notification Services 的事件。

我們將使用 Windows Phone 開發環境的 Microsoft Visual Studio 2010 Express，並部署到 Windows Phone 模擬器來除錯，我們要使用的解決方案是以 Silverlight for Windows Phone Application 範本發展的。開發過程中，我們將增加一個 Windows Phone 的 Silverlight 專案項目－ Windows Phone Portrait Page (直向頁)。

注意：本實驗的步驟示範使用 Microsoft Visual Studio 2010 Express for Windows Phone 的過程，但它們同樣適用於 Microsoft Visual Studio 2010 for Windows Phone。一般涉及到 Visual Studio 的用法說明同樣適用於這兩種產品。

任務 1 – 建立 Weather Service Solution

在此任務中，您將使用本實驗提供的 Microsoft Visual Studio 2010 Express for Windows Phone 或 Microsoft Visual Studio 2010 啟動解決方案。它包括簡單的 WPF 用戶端應用程式，該程式透過 Microsoft Push Notification Service 發送消息到Windows Phone 7 應用程式並承載 WCF 註冊服務，這個服務將在本任務過程中建立。這裡提供的 WPF 應用程式會自我裝載 (self-hosting) RESTful WCF 服務。為此本專案已經擁有所有的需要的配置。

1. 從開始|所有程式| Microsoft Visual Studio 2010 Express | Microsoft Visual Studio 2010 Express for Windows Phone 中打開 Microsoft Visual Studio 2010 Express for Windows Phone 。

Visual Studio 2010：從開始|所有程式| Microsoft Visual Studio 2010打開 Visual Studio 2010。

重要提醒：為了執行自我裝載 WCF 服務，Visual Studio 2010 Express for Windows Phone 或者Microsoft Visual Studio 2010 必須在管理模式下打開。關於建立和提供自我裝載 WCF 服務請參考MSDN 文章 (http://msdn.microsoft.com/en-us/library/ms731758.aspx)。在管理模式下打開Visual Studio 2010 Express for Windows Phone or Visual Studio 2010，找到Microsoft Visual Studio 2010 Express for Windows Phone 快捷方式Start | All Programs | Microsoft Visual Studio 2010 Express 或者 Microsoft Visual Studio 2010 快捷方式Start | All Programs | Microsoft Visual Studio 2010，在圖示上按一下右鍵，然後從快顯功能表中選擇 “Run as administrator”。可能會彈出 UAC 提示，點按“Yes” 來允許 Visual Studio 2010 Express for Windows Phone 或者Visual Studio 2010 使用管理員許可權。

2. 在 File 功能表中，選擇 Open Project。

Visual Studio 2010：在 File 功能表中，指向 open 然後選擇Project / Solution。

3. 找到位於本實驗 Source \ Ex1- RawNotifications \ Begin 資料夾中的 starter 專案，選擇Begin.sln，然後點擊 Open。

圖 6
打開 starting 專案

4. 檢查打開的專案：

a. 這是一個標準的 WPF 應用程式。

注意：為了支援自我裝載 RESTful WCF 服務，此應用程式執行於 .NET Framework 4 而不是 .NET Framework 4 Client Profile。

NOTE

在 Visual Studio 2010 內，只要是主控台、Windows Forms 或 WPF 應用程式專案範本，在一開始建立專案時的類別庫是使用 .NET Framework 4 Client Profile，這個類別庫是 .NET Framework 4 類別庫的子集，擁有基本的 .NET Framework 4 應用程式所需的功能，但部份特殊功能沒有，本實驗中所需要的 WCF 服務類別庫在 .NET Framework 4 Client Profile 內沒有，所以必須要用 .NET Framework 4。

b. WPF 應用程式由 MainWindow 螢幕，PushNotificationsLogViewer 使用者控制項和 StatusToBrush 值轉換器 (Value Converter) 組成。

c. 在“Service” 專案資料夾中包括了 WCF RESTful 服務需要的介面定義。

d. 除了標準 WPF 應用程式引用，該應用程式還引用 system.serviceModel 和 System.ServiceModel.Web 元件來支援 RESTful 的 WCF 服務。

5. 按 F5 編譯並執行應用程式。熟悉一下它然後關閉應用程式並回到 Visual Studio，應用程式允許你發送Tile，Toast 和 Raw HTTP 通知。

圖 7
Push Notification 用戶端應用程式

6. 在接下來的幾個步驟，您將建立一個 WCF 服務實體並初始化它。為了能與 Push Notification Service 通信，叫用者必須提供註冊服務時的 URI。你將在本實驗的下面幾個任務中建立通道並註冊服務。在Service 專案資料夾中添加新類別。為此，在專案資料夾上點擊右鍵並選擇 AddàNew Class。

圖 8
在項目中添加新類別

7. 命名為 RegistrationService，然後點擊 Add 按鈕。

圖 9
命名新類別

8. 打開新建立的類別。

9. 將建立的類別設為 public 並實作 IRegistrationService 介面。這個介面定義了一套方法來註冊手機的 URI。

(Code Snippet – Using Push Notifications – Registration Service – Implementing the interface)

public class RegistrationService : IRegistrationService
{
 
}

10. 點擊 IRegistrationService，透過在 “_” 標誌上停駐以打開快顯功能表。

圖 11
實作介面

12. 類別程式碼如以下程式碼片段所示。你可以添加 IRegistrationService Members 到 region 包圍的地方。

public class RegistrationService : IRegistrationService
{
    #region IRegistrationService Members
    public void Register(string uri)
    {
        throw new NotImplementedException();
    }
 
    public void Unregister(string uri)
    {
        throw new NotImplementedException();
    }
    #endregion
}

13. 註冊服務在內部清單中保存所有註冊客戶，並提醒用戶端是否註冊。另外它會檢查用戶端請求是否已經註冊以避免重複註冊。為支援此功能，添加以下類別變數(public 和private)：

(Code Snippet – Using Push Notifications – Registration Service – Class variables)

public static event EventHandler<SubscriptionEventArgs> Subscribed;
 
private static List<Uri> subscribers = new List<Uri>();
private static object obj = new object();

14. 使用以下程式碼片段替換 Register 函數內容：

(Code Snippet – Using Push Notifications – Registration Service – Register function body)

Uri channelUri = new Uri(uri, UriKind.Absolute);
Subscribe(channelUri);

15. 使用以下程式碼片段替換 Unregister 函數內容：

(Code Snippet – Using Push Notifications – Registration Service – Unregister function body)

Uri channelUri = new Uri(uri, UriKind.Absolute);
Unsubscribe(channelUri);

16. 使用以下程式碼片段建立一個新region，包括 Subscribe 和 Unsubscribe 輔助函數：

(Code Snippet – Using Push Notifications – Registration Service – Subscription and Unsubscription region)

#region Subscription/Unsubscribing logic
private void Subscribe(Uri channelUri)
{
    lock (obj)
    {
            if (!subscribers.Exists((u) => u == channelUri))
            {
                subscribers.Add(channelUri);
            }
    }
    OnSubscribed(channelUri, true);
}
 
public static void Unsubscribe(Uri channelUri)
{
    lock (obj)
    {
        subscribers.Remove(channelUri);
    }
      OnSubscribed(channelUri, false);
}
#endregion

17. 使用以下程式碼片段建立 OnSubscribed 函數：

(Code Snippet – Using Push Notifications – Registration Service – OnSubscribed function region)

#region Helper private functionality
private static void OnSubscribed(Uri channelUri, bool isActive)
{
    EventHandler<SubscriptionEventArgs> handler = Subscribed;
    if (handler != null)
    {
          handler(null, 
            new SubscriptionEventArgs(channelUri,                                         isActive));
    }
}
#endregion

18. 為保存 Subscribed 事件參數，使用以下程式碼片段建立 SubscriptionEventArgs 內部類別 (在RegistrationService 類別中)：

(Code Snippet – Using Push Notifications – Registration Service – SubscriptionEventArgs internal class region)

#region Internal SubscriptionEventArgs class definition
public class SubscriptionEventArgs : EventArgs
{
    public SubscriptionEventArgs(Uri channelUri, bool isActive)
    {
        this.ChannelUri = channelUri;
        this.IsActive = isActive;
    }
 
    public Uri ChannelUri { get; private set; }
    public bool IsActive { get; private set; }
}
#endregion

19. 最後在類別中建立一個公用函數，返回所有訂閱者列表－後面的 WPF 用戶端應用程式會用到它。

(Code Snippet – Using Push Notifications – Registration Service – GetSubscribers helper function region)

#region Helper public functionality
public static List<Uri> GetSubscribers()
{
    return subscribers;
}
#endregion

20. 打開 App.xaml.cs 文件。

21. 找到程式碼行 “//TODO - remove remark after creating registration service” 並從 WCF 服務主機初始化中刪除註解 (如下所示)：

//TODO - remove remark after creating registration service
host = new ServiceHost(typeof(RegistrationService));
host.Open();

22. 編譯並執行應用程式。應用程式啟動之後，要檢查 RESTful WCF 服務是否可用。為此在 RegistrationService.cs 類別的Register 和 / 或 Unregister functions 內加上一個中斷點。

圖 12
使用中斷點檢查 RESTful WCF 服務

23. 執行Internet Explorer 並轉到下面位址：

http://localhost:8000/RegirstatorService/Register?uri=http://www.microsoft.com

24. 當中斷點命中時，檢查收到的 URI 位址是否為 http://www.microsoft.com。

圖 13
檢查 RESTful WCF 服務

25. 停止除錯，刪除中斷點並關閉 Internet Explorer。

26. 為了與Push Notification Service 通信，需要建立一個工具類別。這個類別會擁有所有通訊邏輯。從本實驗的 Source \ Assets 資料夾添加NotificationSenderUtility 項目。這是一個引用了 .NET 4 Framework 的空類別庫專案，而不是 .NET 4 Framework Client Profile。

27. 打開 NotificationSenderUtility.cs 空類別。

28. 這個類別包含與 Microsoft Push Notification Service 通信的所有必需功能。接下來的幾步中，你會添加功能來編寫並發送消息到Push Notification Services。與此同時你會公開 WPF Client 應用程式要使用的公用函數，並使之能夠向已註冊用戶端發送消息。這個類會使用非同步方式與 Push Notification Service 通信，並使用回呼函數 (callback function) 提醒叫用者。

為了方便建立業務邏輯和管理各種通知類型，在名稱空間中添加一個新的 NotificationType 列舉型別 (在 NotificationSenderUtility 類別上面或者下面)。

(Code Snippet – Using Push Notifications – NotificationSenderUtility – NotificationType Enum)

#region NotificationType Enum
public enum NotificationType
{
    Token = 1,
    Toast = 2,
    Raw = 3
}
#endregion

29. 下一步，緊接著 Enum 定義 (NotificationSenderUtility 類別之外) 添加一個類別來保存從 Push Notification Service 接收的資料：

(Code Snippet – Using Push Notifications – NotificationSenderUtility – CallbackArgs class)

#region Event & Event Handler Definition
public class CallbackArgs
{
    public CallbackArgs(NotificationType notificationType, HttpWebResponse response)
    {
        this.Timestamp = DateTimeOffset.Now;
        this.MessageId = response.Headers[NotificationSenderUtility.MESSAGE_ID_HEADER];
        this.ChannelUri = response.ResponseUri.ToString();
        this.NotificationType = notificationType;
        this.StatusCode = response.StatusCode;
        this.NotificationStatus = response.Headers[NotificationSenderUtility.NOTIFICATION_STATUS_HEADER];
        this.DeviceConnectionStatus = response.Headers[NotificationSenderUtility.DEVICE_CONNECTION_STATUS_HEADER];
        this.SubscriptionStatus = response.Headers[NotificationSenderUtility.SUBSCRIPTION_STATUS_HEADER];
    }
 
    public DateTimeOffset Timestamp { get; private set; }
    public string MessageId { get; private set; }
    public string ChannelUri { get; private set; }
    public NotificationType NotificationType { get; private set; }
    public HttpStatusCode StatusCode { get; private set; }
    public string NotificationStatus { get; private set; }
    public string DeviceConnectionStatus { get; private set; }
    public string SubscriptionStatus { get; private set; }
}
#endregion

30. 下面在 NotificationSenderUtility 類中添加與 Push Notification Service 通信相關的常數。

(Code Snippet – Using Push Notifications – NotificationSenderUtility – Push Notification Service communication constants)

#region Local constants
public const string MESSAGE_ID_HEADER = "X-MessageID";
public const string NOTIFICATION_CLASS_HEADER = "X-NotificationClass";
public const string NOTIFICATION_STATUS_HEADER = "X-NotificationStatus";
public const string DEVICE_CONNECTION_STATUS_HEADER = "X-DeviceConnectionStatus";
public const string SUBSCRIPTION_STATUS_HEADER = "X-SubscriptionStatus";
public const string WINDOWSPHONE_TARGET_HEADER = "X-WindowsPhone-Target";
public const int MAX_PAYLOAD_LENGTH = 1024;
#endregion

31. 建立委派回呼函數，並添加輔助函數來執行委派回呼 (delegated callback)：

(Code Snippet – Using Push Notifications – NotificationSenderUtility – Notification Callback Delegate)

#region Notification Callback Delegate Definition
public delegate void SendNotificationToMPNSCompleted(CallbackArgs response);
#endregion

(Code Snippet – Using Push Notifications – NotificationSenderUtility – Helper function to executed delegated callback function)

#region Callback call
protected void OnNotified(NotificationType notificationType,                 HttpWebResponse response,                             SendNotificationToMPNSCompleted callback)
{
    CallbackArgs args = new CallbackArgs(notificationType, response);
    if (null != callback)
        callback(args);
}
#endregion

32. 接下來的幾步中你會建立功能來發送 RAW HTTP 通知到 Push Notification Service。在這些步驟中，你會建立一個通用函數，它會根據通知類型準備並發送的消息。首先，建立一個名為SendRawNotifiaction 的 public 函數來向所有訂閱客戶發送 RAW HTTP 通知。在 NotificationSenderUtility 類別中添加以下程式碼片段：

(Code Snippet – Using Push Notifications – NotificationSenderUtility – SendRawNotifiaction function)

#region SendXXXNotification functionality
public void SendRawNotification(List<Uri> Uris, byte[] Payload, SendNotificationToMPNSCompleted callback)
{
    foreach (var uri in Uris)
        SendNotificationByType(uri, Payload, NotificationType.Raw, callback);
}
#endregion

33. 接下來，添加一個 SendNotificationByType 函數－通用函數，用來叫用指定的發送功能：

(Code Snippet – Using Push Notifications – NotificationSenderUtility – SendNotificationByType function)

#region SendNotificatioByType Logic
private void SendNotificationByType(Uri channelUri, byte[] payload, NotificationType notificationType, SendNotificationToMPNSCompleted callback)
{
    try
    {
        SendMessage(channelUri, payload, notificationType, callback);
    }
    catch (Exception ex)
    {
        throw;
    }
}
#endregion

34. Microsoft Push Notification Service 是一個雲端服務，它用於推送消息到 Windows Phone 7 訂閱客戶。本任務中隨後你會建立一個 Windows Phone 7 應用程式，這個應用程式會打開一個來自此服務的推送通道。從 Push Notification Service 訂閱流程返回的回復就是通道 URI －用戶端設備的唯一標識。為了推送通知訊息到設備，Push Notification Service 在這個 URI 上等待包含送往此設備的資料負載的 web 叫用(web 請求)。收到請求後，Push Notification Service 會找到此設備並發送資料封包 (payload of data)。前面的步驟中，你建立了叫用服務所必需的功能。

SendMessage 函數負責通信，它會檢查資料封包的長度並在長度超過時拋出例外。如果封包正常，它會使用 HttpWebRequest 類別 (來自System.Net namespace，更多消息參考：http://msdn.microsoft.com/en-us/library/system.net.httpwebrequest.aspx) 來準備並向 URI 通道寫入請求資料流。發送資訊後，此函數等待來自 Push Notification Service 的回覆，然後透過委派回呼的方法通知叫用者函數。

添加以下函數，用來向 Push Notification Service 發送請求：

(Code Snippet – Using Push Notifications – NotificationSenderUtility – SendMessage function)

#region Send Message to Microsoft Push Service
private void SendMessage(Uri channelUri, byte[] payload, NotificationType notificationType, SendNotificationToMPNSCompleted callback)
{
    //Check the length of the payload and reject it if too long
    if (payload.Length > MAX_PAYLOAD_LENGTH)
        throw new ArgumentOutOfRangeException("Payload is too long. Maximum payload size shouldn't exceed " + MAX_PAYLOAD_LENGTH.ToString() + " bytes");
 
    try
    {
        // TODO : send message to MPNS
    }
    catch (WebException ex)
    {
        if (ex.Status == WebExceptionStatus.ProtocolError)
        {
            //Notify client on exception
            OnNotified(notificationType, (HttpWebResponse)ex.Response, callback);
        }
 
        throw;
    }
}
#endregion

35. 在 try 區塊中，找到 “// TODO : send message to MPNS” 注釋，用下面的 HttpWebRequest 初始化替換掉：

(Code Snippet – Using Push Notifications – NotificationSenderUtility – HttpWebRequest initializations)

//Create and initialize the request object
HttpWebRequest request = (HttpWebRequest)WebRequest.Create(channelUri);
request.Method = WebRequestMethods.Http.Post;
request.ContentType = "text/xml; charset=utf-8";
request.ContentLength = payload.Length;
request.Headers[MESSAGE_ID_HEADER] = Guid.NewGuid().ToString();
request.Headers[NOTIFICATION_CLASS_HEADER] = ((int)notificationType).ToString();
 
if (notificationType == NotificationType.Toast)
   request.Headers[WINDOWSPHONE_TARGET_HEADER] = "toast";
else if (notificationType == NotificationType.Token)
   request.Headers[WINDOWSPHONE_TARGET_HEADER] = "token";

36. 現在，當請求準備好之後，你需要用非同步方式打開它。當資料流打開時，你會得到 Stream 物件 (來自 System.IO namespace，更多資訊：http://msdn.microsoft.com/en-us/library/system.io.stream.aspx)。這個 Stream 物件代表請求資料流並會用來 (非同步) 寫入封包。寫入過程結束後，函數會切換到獲取 Push Notification Service 的回覆，收到回覆後它會使用委派函數來通知叫用者。將以下程式碼片段添加到函數內容，位於上一步驟的程式碼片段之後 (在try 語句之內) ：

(Code Snippet – Using Push Notifications – NotificationSenderUtility – MPNS call)

request.BeginGetRequestStream((ar) =>
{
    //Once async call returns get the Stream object
    Stream requestStream = request.EndGetRequestStream(ar);
 
    //and start to write the payload to the stream asynchronously
    requestStream.BeginWrite(payload, 0, payload.Length, (iar) =>
    {
        //When the writing is done, close the stream
        requestStream.EndWrite(iar);
        requestStream.Close();
 
        //and switch to receiving the response from MPNS
        request.BeginGetResponse((iarr) =>
        {
            using (WebResponse response = request.EndGetResponse(iarr))
            {
                //Notify the caller with the MPNS results
                OnNotified(notificationType, (HttpWebResponse)response, callback);
            }
        },
        null);
    },
    null);
},
null);

37. 保存並關閉 NotificationSenderUtility 類別。

38. 從 Weather 應用程式中添加一個引用到 NotificationSenderUtility 類別庫，在Weather 專案的 References 資料夾上點擊右鍵，然後選擇 Add Reference。

圖 14
添加引用

39. 在打開的對話方塊中，點擊 Projects 頁籤，選擇 NotificationSenderUtility 並點擊 OK。

圖 15
添加專案引用

40. 打開位於 Weather 專案之下的 MainWindow.xaml.cs。

41. 在類別中添加以下 using 宣告：

(Code Snippet – Using Push Notifications – MainWindow.xaml.cs – Using statements)

using System.Collections.ObjectModel;
using System.Threading;
using System.IO;
using System.Xml;
using WindowsPhone.PushNotificationManager;
using WeatherService.Service;

42. 找到 Private variables 區域並使用以下程式碼片段替換 “TODO” 注釋：

(Code Snippet – Using Push Notifications – MainWindow.xaml.cs – Private variables)

private ObservableCollection<CallbackArgs> trace = new ObservableCollection<CallbackArgs>();
private NotificationSenderUtility notifier = new NotificationSenderUtility();
private string[] lastSent = null;

43. 我們的 Windows Phone 7 用戶端應用程式馬上就會擁有邏輯去訂閱前面建立的註冊服務。WPF 用戶端應用程式透過推送天氣資訊到連線的用戶端來類比真實世界網站解決方案，因此它應該瞭解用戶端Windows Phone 7 應用程式並接收註冊事件。另外，我們的 WPF 用戶端會顯示 Push notification Service 通信日誌。找到MainWindow 類別的建構函數並添加以下程式碼片段到“TODO” 注釋後面：

(Code Snippet – Using Push Notifications – MainWindow.xaml.cs – Ctor additional initializations)

Log.ItemsSource = trace;
RegistrationService.Subscribed += new EventHandler<RegistrationService.SubscriptionEventArgs>(RegistrationService_Subscribed);

44. 找到 Event Handlers 區域並添加以下函數：

(Code Snippet – Using Push Notifications – MainWindow.xaml.cs – RegistrationService_Subscribed function)

void RegistrationService_Subscribed(object sender, RegistrationService.SubscriptionEventArgs e)
{
    //Check previous notifications, and resent last one to connected client
 
    Dispatcher.BeginInvoke((Action)(() => 
        { UpdateStatus(); })
    );
}

45. 在前面的函數之後，添加以下程式碼作為 NotificationSenderUtility 的回呼函數：

(Code Snippet – Using Push Notifications – MainWindow.xaml.cs – OnMessageSent function)

private void OnMessageSent(CallbackArgs response)
{
   Dispatcher.BeginInvoke((Action)(() => {         trace.Add(response); }));
}

46. 找到 Private functionality 區域並添加以下函數 (這個函數更新 WPF 用戶端應用程式 UI)：

(Code Snippet – Using Push Notifications – MainWindow.xaml.cs – UpdateStatus function)

private void UpdateStatus()
{
   int activeSubscribers =     RegistrationService.GetSubscribers().Count;
   bool isReady = (activeSubscribers > 0);
   txtActiveConnections.Text = activeSubscribers.ToString();
   txtStatus.Text = isReady ? "Ready" : "Waiting for connection...";
}

47. 找到 sendHttp 函數並添加以下程式碼。這個函數得到連線的用戶端清單，從 UI 輸入準備負載並使用一個 ThreadPool 透過 NotificationSenderUtility 非同步發送它 (來自System.Threading namespace. 瞭解更多 ThreadPool 的資訊，參考：http://msdn.microsoft.com/en-us/library/system.threading.threadpool.aspx)：

(Code Snippet – Using Push Notifications – MainWindow.xaml.cs – sendHttp function body)

//Get the list of subscribed WP7 clients
List<Uri> subscribers = RegistrationService.GetSubscribers();
//Prepare payload
byte[] payload = prepareRAWPayload(
    cmbLocation.SelectedValue     as string,
     sld.Value.ToString("F1"),
    cmbWeather.SelectedValue as string);
//Invoke sending logic asynchronously
ThreadPool.QueueUserWorkItem((unused) =>     notifier.SendRawNotification(subscribers, 
                        payload, 
                        OnMessageSent)
    );
 
//Save last RAW notification for future usage
lastSent = new string[3];
lastSent[0] = cmbLocation.SelectedValue as string;
lastSent[1] = sld.Value.ToString("F1");
lastSent[2] = cmbWeather.SelectedValue as string;

注意：在我們的具體情況下，當 NotificationSenderUtility 已經實現非同步通訊方式，沒有絕對必要使用 ThreadPool 非同步叫用功能，但是一般 d 來說會推薦使用這種最佳實踐方式 (Best Practice) 以叫用通信功能。通訊是一個長時間執行的行程，如果內部不能支援非同步作業，即使是簡單的叫用都會凍結 UI。這就是為什麼一般情況下叫用長時間執行的行程都會使用非同步方式。

48. 找到 Private functionality 區域並添加 prepareRAWPayload 函數。這個函數在記憶體中建立一個 XML 文件並傳回一個 byte 陣列 (可以隨時發送到 Windows Phone Push Notification Services 然後從那裡傳送到 Windows Phone 應用程式客戶)。本練習的後面你會在終端設備上添加功能來重新解析成 XML。添加以下程式碼片段：

(Code Snippet – Using Push Notifications – MainWindow.xaml.cs – PrepareRAWPayload function)

private static byte[] prepareRAWPayload(string location,             string temperature, string weatherType)
{
   MemoryStream stream = new MemoryStream();
 
   XmlWriterSettings settings = new XmlWriterSettings() 
    { Indent = true, Encoding = Encoding.UTF8 };
   XmlWriter writer = XmlTextWriter.Create(stream,                                 settings);
 
   writer.WriteStartDocument();
   writer.WriteStartElement("WeatherUpdate");
 
   writer.WriteStartElement("Location");
   writer.WriteValue(location);
   writer.WriteEndElement();
 
   writer.WriteStartElement("Temperature");
   writer.WriteValue(temperature);
   writer.WriteEndElement();
 
   writer.WriteStartElement("WeatherType");
   writer.WriteValue(weatherType);
   writer.WriteEndElement();
 
   writer.WriteStartElement("LastUpdated");
   writer.WriteValue(DateTime.Now.ToString());
   writer.WriteEndElement();
 
   writer.WriteEndElement();
   writer.WriteEndDocument();
   writer.Close();
 
   byte[] payload = stream.ToArray();
   return payload;
}

49. 找到 RegistrationService_Subscribed 函數，並在 UpdateStatus 叫用之前添加以下程式碼片段來重新發送 RAW 消息到連線客戶：

(Code Snippet – Using Push Notifications – MainWindow.xaml.cs – Resend RAW message)

void RegistrationService_Subscribed(object sender, RegistrationService.SubscriptionEventArgs e)
{
    //Check previous notifications, and resent last one to connected client
    if (null != lastSent)
    {
        string location = lastSent[0];
        string temperature = lastSent[1];
        string weatherType = lastSent[2];
        List<Uri> subscribers = new List<Uri>();
        subscribers.Add(e.ChannelUri);
        byte[] payload = prepareRAWPayload(location, temperature, weatherType);
 
        ThreadPool.QueueUserWorkItem((unused) => notifier.SendRawNotification(subscribers, payload, OnMessageSent));
    }
 
    Dispatcher.BeginInvoke((Action)(() =>
    { UpdateStatus(); })
        );
}

50. 編譯應用程式並修正編譯錯誤 (如果有的話)。本任務到此結束。

任務 2 – 建立 Windows Phone 7 Client 應用程式

1. 在solution 中添加新的專案。選擇 Windows Phone Application，命名為 PushNotifications。

圖 16
Solution 中添加新 Windows Phone Application 專案

2. 添加 System.Xml.Linq 組件的引用 (從 .NET 選項頁籤)：

圖 17
添加引用到 System.Xml.Linq

3. 在本實驗的 Source \ Assets 下找到 Assets 資料夾並找到 Styles.txt。使用記事本打開它。

4. 打開 App.xaml.cs 並從 Styles.txt 中拷貝所有的 XAML 到 Application.Resources 部分。

5. 為 System CLR 命名空間添加以下藍色反白的 clr-namespace 宣告，位於 Application 標記內 (靠近檔頂部)。

XAML

<Application     ...    xmlns:system="clr-namespace:System;assembly=mscorlib">    ...</Application>

6. 從 Assets 資料夾找到名為 CloudBackgroundMobile.jpg 的圖片添加到專案。為此在 PushNotifications (專案名稱) 上點擊右鍵然後選擇 Add à Existing Item。在“Add Existing Item” 對話方塊中，找到Source \ Assets 資料夾，選擇 CloudBackgroundMobile.jpg 並點擊 Add 按鈕。

圖 18
添加現有圖像資源

7. 打開 MainPage.xaml (如果沒有自動打開的話)。

8. 找到 LayoutRoot grid，並使用以下程式碼片段替換其內容：

XAML

<Grid x:Name="LayoutRoot" Background="Transparent">   <Grid.RowDefinitions>      <RowDefinition Height="120"/>      <RowDefinition Height="*"/>      <RowDefinition Height="150"/>      <RowDefinition Height="Auto"/>   </Grid.RowDefinitions>   <Image Source="cloudbackgroundmobile.jpg" Grid.RowSpan="4" />        <Grid x:Name="TitleGrid" Grid.Row="0" VerticalAlignment="Top">            <TextBlock Text="WEATHER SERVICE" x:Name="textBlockPageTitle" Style="{StaticResource PhoneTextPageTitle1Style}" />        </Grid>        <Grid Grid.Row="1" x:Name="ContentPanel" Background="#10000000">            <TextBlock x:Name="textBlockListTitle" FontFamily="Segoe WP Light" FontSize="108" Text="City" Margin="20,10,0,0" />            <TextBlock x:Name="txtTemperature" FontFamily="Segoe WP" FontSize="160" Text="80°" Margin="20,100,0,0" />            <Image x:Name="imgWeatherConditions" Width="128" Height="128" Stretch="None" HorizontalAlignment="Right" VerticalAlignment="Top" Margin="20,155,20,0" />        </Grid>        <StackPanel Grid.Row="3" x:Name="StatusStackPanel" Margin="20">            <TextBlock FontSize="34" FontFamily="Segoe WP Semibold" Foreground="#104f6f" Text="Status" Style="{StaticResource PhoneTextNormalStyle}" />            <TextBlock x:Name="txtStatus" FontFamily="Segoe WP" FontSize="24" Foreground="#0a364c" Margin="0,0,0,0" Style="{StaticResource PhoneTextNormalStyle}" Text="Not Connected" TextWrapping="Wrap" />        </StackPanel></Grid>

9. 打開 MainPage.xaml.cs。

10. 添加以下 using 宣告：

(Code Snippet – Using Push Notifications – MainPage.xaml.cs – Using statments)

using Microsoft.Phone.Notification;
using System.Diagnostics;
using System.Windows.Threading;
using System.Windows.Media.Imaging;
using System.IO;
using System.Xml.Linq;
using System.IO.IsolatedStorage;
using System.Collections.ObjectModel;

11. 在類別的開始部分添加以下程式碼片段，包含一些私有變數和常數：

(Code Snippet – Using Push Notifications – MainPage.xaml.cs – Private variables)

private HttpNotificationChannel httpChannel;
const string channelName = "WeatherUpdatesChannel";
const string fileName = "PushNotificationsSettings.dat";
const int pushConnectTimeout = 30;

12. 添加以下帶有輔助函數的程式碼片段。這些函數會更新Windows Phone 7 應用程式的 UI 狀態條並輸出有用的追蹤資訊：

(Code Snippet – Using Push Notifications – MainPage.xaml.cs – Updating and Tracing functions)

#region Tracing and Status Updates
private void UpdateStatus(string message)
{
   txtStatus.Text = message;
}
 
private void Trace(string message)
{
#if DEBUG
   Debug.WriteLine(message);
#endif
}
#endregion

13. 設置 PushNotifications 專案為啟動專案。為此在專案名稱上點擊右鍵，然後選擇 Set as Startup Project。

圖 19
設置 PushNotification 為啟動專案

14. 編譯並執行應用程式。

15. 此階段應用程式應該如下所示：

圖 20
執行 Weather 用戶端

16. 停止除錯並回到程式碼。本任務到此結束。

任務 3 – 建立 Notification 通道

在接下來的幾個步驟，您要開發建立新的 Push Notification 通道和訂閱通道事件所必需的功能。HttpNotificationChannel 是一個在 Push Notification 服務和 Push Client 之間建立通知通道的類別，它用來建立一個 raw，tile和toast 通知的訂閱。該通道的創造流程是這樣的：如果通道已經存在，則用戶端應用程式應嘗試重新打開它。試圖重新建立已存在的通道將導致例外。如果通道沒有打開，訂閱通道事件，並嘗試打開通道。一旦通道打開它會觸發 ChannelUriUpdated 事件。此事件可能向用戶端發送成功建立通道的信號。現有的通道可以根據名稱找到，成功找到通道的情況下，通道將被重新啟動，並可以在應用程式中使用。整個過程是非同步的。

1. 從 PushNotifications 專案打開 MainPage.xaml.cs。

注意：在當前版本的模擬器存在一個錯誤，模擬器啟動之後立刻試圖打開新的通道會導致一個例外。此錯誤會阻礙模擬器打開一個有效的管道 20 – 30 秒，並且每次啟動模擬器都會出現。為了繞過這個問題，本實驗將檢查此例外，將應用程式執行延遲 30 秒。過了這段時間後停止應用程式，然後再執行它一次就可以了。請不要在應用程式啟動之間關閉模擬器。

2. 使用以下程式碼片段為其他功能建立一個新 region：

(Code Snippet – Using Push Notifications – MainPage.xaml.cs – DoConnect function)

#region Misc logic
private void DoConnect()
{ 
   //TODO - place connection logic here
}
#endregion

3. 使用以下程式碼片段在 DoConnect 函數內建立 Try / Catch 塊：

(Code Snippet – Using Push Notifications – MainPage.xaml.cs – DoConnect try-catch block in function body)

try
{
 
}
catch (Exception ex)
{
   Dispatcher.BeginInvoke(() => UpdateStatus("Channel error: " + ex.Message));
}

4. 下一步，初始化一個通道變數，訂閱通道事件並嘗試打開通道。使用以下程式碼片段建立 try 塊主體：

(Code Snippet – Using Push Notifications – MainPage.xaml.cs – DoConnect try block body)

//First, try to pick up existing channel
httpChannel = HttpNotificationChannel.Find(channelName);
 
if (null != httpChannel)
{
   Trace("Channel Exists - no need to create a new one");
   SubscribeToChannelEvents();
 
   Trace("Register the URI with 3rd party web service");
   SubscribeToService();
 
   //TODO: Place Notification
 
   Dispatcher.BeginInvoke(() => UpdateStatus("Channel recovered"));
}
else
{
   Trace("Trying to create a new channel...");
   //Create the channel
   httpChannel = new HttpNotificationChannel(channelName, "HOLWeatherService");
   Trace("New Push Notification channel created successfully");
 
   SubscribeToChannelEvents();
 
   Trace("Trying to open the channel");
   httpChannel.Open();
   Dispatcher.BeginInvoke(() => UpdateStatus("Channel open requested"));
}

5. 建立一個輔助函數，用來訂閱通道事件：

(Code Snippet – Using Push Notifications – MainPage.xaml.cs – SubscribeToChannelEvents function)

#region Subscriptions
private void SubscribeToChannelEvents()
{
   //Register to UriUpdated event - occurs when channel successfully opens
   httpChannel.ChannelUriUpdated += new EventHandler<NotificationChannelUriEventArgs>(httpChannel_ChannelUriUpdated);  
 
   //Subscribed to Raw Notification
   httpChannel.HttpNotificationReceived += new EventHandler<HttpNotificationEventArgs>(httpChannel_HttpNotificationReceived);
 
   //general error handling for push channel
   httpChannel.ErrorOccurred += new EventHandler<NotificationChannelErrorEventArgs>(httpChannel_ExceptionOccurred);
}
#endregion

6. 添加一個輔助函數，在Windows Phone 7 用戶端訂閱Push Notification Service 消息。這個訂閱要透過向前面任務中建立的服務註冊並接收通道 URI 完成。在我們這個例子中，此函數使用 WebClient 和寫死於程式碼內的 RESTful WCF 服務 URL 來註冊Client’s URI (接收自推送伺服器)。在前面插入的 Subscriptions 區域添加以下程式碼片段：

(Code Snippet – Using Push Notifications – MainPage.xaml.cs – SubscribeToService function)

private void SubscribeToService()
{
   //Hardcode for solution - need to be updated in case the REST WCF service address change
   string baseUri = "http://localhost:8000/RegirstatorService/Register?uri={0}"; 
   string theUri = String.Format(baseUri,         httpChannel.ChannelUri.ToString());
   WebClient client = new WebClient();
   client.DownloadStringCompleted += (s, e) =>
   {
      if (null == e.Error)
         Dispatcher.BeginInvoke(() =>                             UpdateStatus("Registration succeeded"));
      else
         Dispatcher.BeginInvoke(() =>                             UpdateStatus("Registration failed: " +                         e.Error.Message));
   };
   client.DownloadStringAsync(new Uri(theUri));
}

7. 建立事件處理函數處理 ChannelUriUpdate 事件：

(Code Snippet – Using Push Notifications – MainPage.xaml.cs – httpChannel_ChannelUriUpdated function)

#region Channel event handlers
void httpChannel_ChannelUriUpdated(object sender, NotificationChannelUriEventArgs e)
{
   Trace("Channel opened. Got Uri:\n" +         httpChannel.ChannelUri.ToString());
 
    Trace("Subscribing to channel events");
    SubscribeToService();
      
    Dispatcher.BeginInvoke(() => UpdateStatus("Channel created successfully"));
}
#endregion

8. 在 region 中添加 ExceptionOccured 事件處理函數：

(Code Snippet – Using Push Notifications – MainPage.xaml.cs – httpChannel_ExceptionOccured function)

void httpChannel_ExceptionOccurred(object sender,  NotificationChannelErrorEventArgs e)
{
   Dispatcher.BeginInvoke(() => UpdateStatus(e.ErrorType + " occurred: " + e.Message));
}

9. 最後在同一 region 中添加 HttpNotificationReceived 事件處理函數：

(Code Snippet – Using Push Notifications – MainPage.xaml.cs – httpChannel_HttpNotificationReceived function)

void httpChannel_HttpNotificationReceived(object sender,  HttpNotificationEventArgs e)
{
            
   Trace("===============================================");
   Trace("RAW notification arrived:");
 
   //TODO - add parsing and UI updating logic here
        
   Trace("===============================================");
}

這個函數解析來自 Push Notification Service 的 XML 負載並負責更新用戶端應用程式的 UI。下一個任務中你會建立它的邏輯。

10. 在類別的建構函數中加入一個對 DoConnect 的叫用。最後的 constructor 應該看上去和下面的程式碼片段相似：

public MainPage()
{
   InitializeComponent();
   DoConnect();
}

11. 編譯應用程式，如果有編譯錯誤，請修改它們。

12. 為 solution 定義多個啟動專案，這樣做的目的是為了同時執行 WPF Push Notification Client 和 Windows Phone 7 Push 用戶端。為此，在 Solution Explorer 中右鍵點擊 solution 名稱並在快顯功能表中選擇Properties：

圖 21
打開 Solution 屬性

13. 從Common Properties 中選擇 Startup Projects 頁 (一般會自動選擇)，選擇Multiple startup projects，並在設置 PushNotifications 和Weather 專案的 Action 為 Start：

圖 22
選擇多個啟動專案

14. 按 F5 編譯並執行應用程式。

15. 所有專案啟動之後你的螢幕應該如下圖所示：

圖 23
執行多個專案

16. 確保 Windows Phone 7 用戶端應用程式成功註冊了Registration Service：

圖 24
檢查用戶端應用程式註冊

17. 在 httpChannel_HttpNotificationReceived 函數中放置一個中斷點。

圖 25
通知事件處理函數中的中斷點

18. 修改 WPF Push Notification Client 的一些參數並點擊 Send Http 按鈕。當中斷點命中時，程式碼執行會暫停，檢查收到的資訊。

圖 26
通知到達時命中中斷點

圖 27
Windows Phone 7 用戶端應用程式接收的通知封包

19. 按 F5 繼續執行程式。觀察 WPF Push Notification Client 新的日誌。

圖 28
更新日誌後的 WPF Push Notification Client

20. 停止除錯並返回 Visual Studio (不要關閉 Windows Phone 7模擬器！). 本任務到此結束。

任務 4 – 接收並處理來自 Push Notification Service 的事件

1. 本任務過程中你會建立一個函數來解析封包中包含的 XML 並更新 Windows Phone 7 應用程式的 UI。添加以下函數到 MainPage.xaml.cs 類別的Misc logic 區域：

(Code Snippet – Using Push Notifications – MainPage.xaml.cs – ParseRAWPayload function)

private void ParseRAWPayload(Stream e, out string weather,     out string location, out string temperature)
{
   XDocument document;
 
   using (var reader = new StreamReader(e))
   {
      string payload = reader.ReadToEnd().Replace('\0', 
        ' ');
      document = XDocument.Parse(payload);
   }
 
   location = (from c in     document.Descendants("WeatherUpdate")
    select c.Element("Location").Value).FirstOrDefault();
   Trace("Got location: " + location);
 
   temperature = (from c in     document.Descendants("WeatherUpdate")
     select     c.Element("Temperature").Value).FirstOrDefault();
   Trace("Got temperature: " + temperature);
 
   weather = (from c in     document.Descendants("WeatherUpdate")
     select     c.Element("WeatherType").Value).FirstOrDefault();
}

2. 為了圖形化地顯示天氣你需要添加一些天氣情況的圖示 (本實驗中作為 assets 提供)。在 PushNotifications 專案中建立一個名為Images 的專案資料夾。

3. 從 Assets 資料夾中添加所有PNG 圖片 (除CloudBackgroundMobile.jpg 之外的所有圖片) (位於Source \ Assets 資料夾)：

圖 29
從 Assets 資料夾中添加所有圖片

圖 30
從 Assets 資料夾中添加現有圖片

4. 把這些圖片的編譯動作標誌為 Content，為此打開圖像的 Properties 並在Build Action 中選擇 Content。

圖 31
將圖像標誌為 Content 資源

5. 回想一下上個任務中建立的最後一個函數 httpChannel_HttpNotificationReceived (在MainPage.xaml.cs)，這個函數會叫用前面建立的解析功能並更新 UI。在 “//TODO - add parsing and UI updating logic here” 注釋後面添加以下藍色反白程式碼片段：

(Code Snippet – Using Push Notifications – MainPage.xaml.cs – httpChannel_HttpNotificationReceived function body)

void httpChannel_HttpNotificationReceived(object sender, HttpNotificationEventArgs e)
{
    Trace("===============================================");
    Trace("RAW notification arrived:");
 
    string weather, location, temperature;
    ParseRAWPayload(e.Notification.Body, out weather, out     location, out temperature);
 
    Dispatcher.BeginInvoke(() => this.textBlockListTitle.Text = location);
    Dispatcher.BeginInvoke(() => this.txtTemperature.Text = temperature);
    Dispatcher.BeginInvoke(() => this.imgWeatherConditions.Source = new BitmapImage(new Uri(@"Images/" + weather + ".png", UriKind.Relative)));
    Trace(string.Format("Got weather: {0} with {1}F at location {2}", weather, temperature, location));
 
    Trace("===============================================");
}

6. 編譯並執行應用程式。當兩個專案都啟動之後，修改 WPF Push Notification Client 中的一些值然後點擊 Send Http 按鈕。觀察一下通知到達 Windows Phone 7 用戶端應用和 UI 變化。觀察 Visual Studio 2010Output 視窗中的跟蹤資訊 Visual Studio 2010 Output (如果 Output 視窗沒有顯示，點擊Debug | Windows | Output 功能表項目或者按 Ctrl+W，O)。

圖 32
Http Notification 到達並被解析

圖 33
Output 視窗中的追蹤資訊

7. 發送不同的通知並觀察 UI 變化。

圖 34
Http Notification 到達並被解析。跟蹤日誌更新

圖 35
Http Notification 到達並被解析。跟蹤日誌更新

8. 在 Visual Studio 中，按 SHIFT+F5 停止除錯並返回編輯模式。

9. 前面提醒過，應用程式應該嘗試恢復已經存在的通道。為此，通道成功打開後首先要被保存，然後應用程式載入時可以按名稱查詢。在 MainPage.xaml.cs 中加入以下程式碼－它包含一個函數，可以利用 Windows Phone 7 應用程式的Isolated Storage (隔離儲存區) 保存並載入通道資訊 (瞭解更多 Silverlight 應用程式 Isolated Storage 的資訊，參考以下文章：http://www.silverlight.net/learn/quickstarts/isolatedstorage/)：

(Code Snippet – Using Push Notifications – MainPage.xaml.cs – Saving and Loading Channel information functionality)

#region Loading/Saving Channel Info
private bool TryFindChannel()
{
    bool bRes = false;
 
    Trace("Getting IsolatedStorage for current Application");
    using (IsolatedStorageFile isf = IsolatedStorageFile.GetUserStoreForApplication())
    {
        Trace("Checking channel data");
        if (isf.FileExists(fileName))
        {
            Trace("Channel data exists! Loading...");
            using (IsolatedStorageFileStream isfs = new IsolatedStorageFileStream(fileName, FileMode.Open, isf))
            {
                using (StreamReader sr = new StreamReader(isfs))
                {
                    string uri = sr.ReadLine();
                    Trace("Finding channel");
                    httpChannel = HttpNotificationChannel.Find(channelName);
 
                    if (null != httpChannel)
                    {
                        if (httpChannel.ChannelUri.ToString() == uri)
                        {
                            Dispatcher.BeginInvoke(() => UpdateStatus("Channel retrieved"));
                            SubscribeToChannelEvents();
                            SubscribeToService();
                            bRes = true;
                        }
 
                        sr.Close();
                    }
                }
            }
        }
        else
            Trace("Channel data not found");
    }
 
    return bRes;
}
 
private void SaveChannelInfo()
{
    Trace("Getting IsolatedStorage for current Application");
    using (IsolatedStorageFile isf = IsolatedStorageFile.GetUserStoreForApplication())
    {
        Trace("Creating data file");
        using (IsolatedStorageFileStream isfs = new IsolatedStorageFileStream(fileName, FileMode.Create, isf))
        {
            using (StreamWriter sw = new StreamWriter(isfs))
            {
                Trace("Saving channel data...");
                sw.WriteLine(httpChannel.ChannelUri.ToString());
                sw.Close();
                Trace("Saving done");
            }
        }
    }
}
#endregion

10. 使用以下程式碼片段修改類別的建構函數來叫用載入功能：

public MainPage()
{
    InitializeComponent();
    if (!TryFindChannel())
        DoConnect();
}

11. 在 httpChannel_ChannelUriUpdate 函數中添加保存通道的功能。在 “Channel opened … ” 後面添加以下程式碼片段：

(Code Snippet – Using Push Notifications – MainPage.xaml.cs – SaveChannelInfo function call)

void httpChannel_ChannelUriUpdated(object sender, NotificationChannelUriEventArgs e)
{
    Trace("Channel opened. Got Uri:\n" + httpChannel.ChannelUri.ToString());
    Dispatcher.BeginInvoke(() => SaveChannelInfo());
    Trace("Subscribing to channel events");
    SubscribeToService();
 
    Dispatcher.BeginInvoke(() => UpdateStatus("Channel created successfully"));
}

12. 編譯並執行程式兩次。使用除錯來檢查第一次應用程式打開並保存了通道資訊，第二次透過名稱找到了通道。

本練習到此結束。本練習過程中你學習了如何與Microsoft Push Notification Services 進行通信，如何準備並發送消息到Windows Phone 7 用戶端應用程式，以及在 Windows Phone 7 中如何接收這些消息。

注意：本練習的完整解決方案位於以下位置：Source \ Ex1-RawNotifications \ End。

練習 2：用於提醒的 Toast 和 Tile Notifications 介紹

這部分你將學習另外兩種類型的通知－ Toast 和Tile 通知。本實驗包括了向 MSPNS 發佈資料的後台伺服器，和如何在你的 Windows Phone 7 應用程式中註冊並處理這些事件。

Tiles 和 toast 通知是兩種機制，它們允許雲端服務在應用程式自己的 UI 之外向使用者投遞相關動態回饋。另外，雲端服務可以發送原始的通知請求。根據發送的通知類型，通知會被路由到應用程式或者是作業系統殼層 (shell)。

Tile Notifications

Tile 是應用程式或者其內容在手機快速啟動區的一個可視的，動態的呈現。例如天氣應用程式可能選擇使用 tile 顯示使用者本地時間和氣候情況。因為雲端服務可能在任何時間變動 tile 的外觀，這種機制可以用來將資訊持續不斷地傳達給用戶。每個手機應用程式都關聯到一個單獨的 tile，但是用戶可以控制哪些 tile 附加到Quick Launch 區。

雲端服務能夠控制 tile 的背景圖片，計數器 (或者徽章) 和標題屬性。這些屬性使用 Windows Phone Developer Tools 來配置。Tile 的動畫和聲音屬性由平臺設置而不是由應用程式來控制。例如，如果平台設置為用動畫和嘟嘟聲來回應任何 tile 更新，這對於任何tile 都是有效的。

Tile 的背景圖片可以參考一個本地資源，是應用程式部署的一部分，或雲端資源。透過引用在雲端中的資源，應用程式得以動態更新 tile 的背景圖像。這使得需要提前進行背景影像處理，然後才顯示出來的場景也能夠得以應用。在大多數情況下，應用套裝程式應包含所有需要的 tile 背景圖片，因此這是提高性能和電池壽命最好的解決方案。

Toast Notifications

雲端服務能夠產生一種特殊的 Push Notification，稱為 toast 通知，它通常在使用者當前螢幕之上疊加顯示。例如，天氣應用程式可能希望將惡劣天氣提醒作為 toast 通知顯示。如果使用者決定點擊 toast 通知，應用程式就會啟動並執行其他動作。

雲端服務能夠控制toast 通知的標題和副標題。toast 通知也會顯示包含在佈署包裡的應用程式圖示。

最佳實踐

Toast 通知應該是與個人相關並且時間上緊急。
Toast 通知應該主要集中在點對點通信。

任務 1 – 實現服務端程式碼來發送 Tiles & Toasts

1. 從開始|所有程式| Microsoft Visual Studio 2010 Express | Microsoft Visual Studio 2010 Express for Windows Phone 中打開 Microsoft Visual Studio 2010 Express for Windows Phone。

Visual Studio 2010：從開始|所有程式| Microsoft Visual Studio 2010 中打開 Visual Studio 2010。

重要提醒：為了執行自我裝載 WCF 服務，Visual Studio 2010 Express for Windows Phone 或者Microsoft Visual Studio 2010 必須在管理模式下打開。關於建立和提供自承 WCF 服務請參考MSDN 文章 (http://msdn.microsoft.com/en-us/library/ms731758.aspx)。在管理模式下打開Visual Studio 2010 Express for Windows Phone or Visual Studio 2010 in Administrative Mode，找到Microsoft Visual Studio 2010 Express for Windows Phone 快捷方式Start | All Programs | Microsoft Visual Studio 2010 Express 或者 Microsoft Visual Studio 2010 快捷方式Start | All Programs | Microsoft Visual Studio 2010，在圖示上按一下右鍵，然後從快顯功能表中選擇 “Run as administrator”。可能會彈出 UAC 提醒，點擊“Yes” 來允許 Visual Studio 2010 Express for Windows Phone 或者Visual Studio 2010 使用管理員許可權。

2. 找到位於本實驗 Source \ Ex2-TileToastNotifications \ Begin 資料夾中的 starter 專案，選擇Begin.sln，然後點擊 Open。你也可以選擇繼續使用前面練習中的 solution。

3. 打開 NotificationSenderUtility.cs 檔，可以在 NotificationSenderUtility 專案下面找到它。

4. Toast 和Tile 通知是 Windows Phone 7 平台系統定義的通知。和 RAW 通知不同，所有的應用程式都可以建立他們自己的負載格式並相應地解析它們。下面幾個步驟中，你會建立一些通用功能來建立Tile & Toast 消息負載－這個負載可以與任何Windows Phone 7 應用程式合作。另外你會暴露公用的功能來發送這些消息並把 WPF Push Notification Client 的按鈕事件連接到它。找到SendXXXNotification functionality 區。添加以下公用函數到這個區 (隨後 WPF 應用程式會用到他們)：

(Code Snippet – Using Push Notifications – NotificationSenderUtility – SendXXXNotification functions)

public void SendToastNotification(List<Uri> Uris, string message1, string message2, SendNotificationToMPNSCompleted callback)
{
   byte[] payload = prepareToastPayload(message1, message2);
 
   foreach (var uri in Uris)
      SendNotificationByType(uri, payload, NotificationType.Toast, callback);
}
 
public void SendTileNotification(List<Uri> Uris, string TokenID, string BackgroundImageUri, int Count, string Title, SendNotificationToMPNSCompleted callback)
{
   byte[] payload = prepareTilePayload(TokenID, BackgroundImageUri, Count, Title);
 
   foreach (var uri in Uris)
      SendNotificationByType(uri, payload, NotificationType.Token, callback);
}

5. 下一步你會建立一個新的區，包含兩個函數－第一個準備 Toast 負載，第二個準備 Tile 負載。

Tile 通知消息應該使用下面的格式。注意 <background image path>，<count> 和 <title> 元素是 string 格式的。

XML

Content-Type: text/xmlX-WindowsPhone-Target: token<?xml version="1.0" encoding="utf-8"?><wp:Notification xmlns:wp="WPNotification">   <wp:Tile>      <wp:BackgroundImage><background image path></wp:BackgroundImage>      <wp:Count><count></wp:Count>      <wp:Title><title></wp:Title>   </wp:Tile> </wp:Notification>

Toast 通知消息則應該使用如下格式，注意 <Text1> 和 <Text2> 是string 格式。

XML

Content-Type: text/xmlX-WindowsPhone-Target: toast<?xml version="1.0" encoding="utf-8"?><wp:Notification xmlns:wp="WPNotification">   <wp:Toast>      <wp:Text1><string></wp:Text1>      <wp:Text2><string></wp:Text2>   </wp:Toast></wp:Notification>

6. 使用以下程式碼片段建立 Prepare Payload 一組函數：

(Code Snippet – Using Push Notifications – NotificationSenderUtility – Prepare Payload functions)

#region Prepare Payloads
private static byte[] prepareToastPayload(string text1, string text2)
{
    MemoryStream stream = new MemoryStream();
    XmlWriterSettings settings = new XmlWriterSettings() { Indent = true, Encoding = Encoding.UTF8 };
    XmlWriter writer = XmlWriter.Create(stream, settings);
    writer.WriteStartDocument();
    writer.WriteStartElement("wp", "Notification", "WPNotification");
    writer.WriteStartElement("wp", "Toast", "WPNotification");
    writer.WriteStartElement("wp", "Text1", "WPNotification");
    writer.WriteValue(text1);
    writer.WriteEndElement();
    writer.WriteStartElement("wp", "Text2", "WPNotification");
    writer.WriteValue(text2);
    writer.WriteEndElement();
    writer.WriteEndElement();
    writer.WriteEndDocument();
    writer.Close();
 
    byte[] payload = stream.ToArray();
    return payload;
}
 
private static byte[] prepareTilePayload(string tokenId, string backgroundImageUri, int count, string title)
{
    MemoryStream stream = new MemoryStream();
    XmlWriterSettings settings = new XmlWriterSettings() { Indent = true, Encoding = Encoding.UTF8 };
    XmlWriter writer = XmlWriter.Create(stream, settings);
    writer.WriteStartDocument();
    writer.WriteStartElement("wp", "Notification", "WPNotification");
    writer.WriteStartElement("wp", "Tile", "WPNotification");
    writer.WriteStartElement("wp", "BackgroundImage", "WPNotification");
    writer.WriteValue(backgroundImageUri);
    writer.WriteEndElement();
    writer.WriteStartElement("wp", "Count", "WPNotification");
    writer.WriteValue(count.ToString());
    writer.WriteEndElement();
    writer.WriteStartElement("wp", "Title", "WPNotification");
    writer.WriteValue(title);
    writer.WriteEndElement();
    writer.WriteEndElement();
    writer.Close();
 
    byte[] payload = stream.ToArray();
    return payload;
}
 
#endregion

7. 在 Weather 專案中打開 MainWindow.xaml.cs。

8. 找到 sendToast 函數，這個函數應該從 Push Notification Client UI 獲取 Toast 消息並發送到所有的訂閱者。在此函數中添加如下程式碼片段：

(Code Snippet – Using Push Notifications – MainWindow.xaml.cs –sendToast function body)

private void sendToast()
{
    string msg = txtToastMessage.Text;
    txtToastMessage.Text = "";
    List<Uri> subscribers = RegistrationService.GetSubscribers();
    ThreadPool.QueueUserWorkItem((unused) => notifier.SendToastNotification(subscribers,
        "WEATHER ALERT", msg, OnMessageSent));
}

9. 找到 sendTile 函數。這個函數從 Push Notification Client UI 獲取參數並發送到所有訂閱者。在此函數內中添加如下程式碼片段：

(Code Snippet – Using Push Notifications – MainWindow.xaml.cs –sendTile function body)

private void sendTile()
{
    string weatherType = cmbWeather.SelectedValue as string;
    int temperature = (int)sld.Value;
    string location = cmbLocation.SelectedValue as string;
    List<Uri> subscribers = RegistrationService.GetSubscribers();
    ThreadPool.QueueUserWorkItem((unused) => notifier.SendTileNotification(subscribers, "PushNotificationsToken", "/Images/" + weatherType + ".png", temperature, location, OnMessageSent));
}

10. 編譯並執行應用程式。檢查消息被發送到 Push Notification Service。

圖 36
WPF Push Notifications Client 日誌

注意：如果你從 Begin solution 開始本練習，而不是在前一練習的基礎上繼續工作，執行應用之前你應該為 solution 設置多個啟動項目，才能同時執行 WPF Push Notification Client 和Windows Phone 7 Push Client。為此，在 Solution Explorer 中右鍵點擊 solution 名稱並在快顯功能表中選擇Properties。從Common Properties 中選擇 Startup Projects 頁(一般會自動選擇)，選擇Multiple startup projects，並設置 PushNotifications 和Weather 專案的 Action 為 Start。

本任務到此結束

任務 2 – 在手機端處理 Tile & Toast Notifications

1. 打開 PushNotifications專案中的MainPage.xaml.cs。

2. 接下來幾步中你會訂閱Tile 和 Toast 通知事件並處理這些事件。找到 Subscriptions 區並添加以下程式碼片段：

(Code Snippet – Using Push Notifications – MainPage.xaml.cs – SubscribeToNotifications function)

private void SubscribeToNotifications()
{
    //////////////////////////////////////////
    // Bind to Toast Notification 
    //////////////////////////////////////////
    try
    {
        if (httpChannel.IsShellToastBound == true)
        {
            Trace("Already bounded (register) to to Toast notification");
        }
        else
        {
            Trace("Registering to Toast Notifications");
            httpChannel.BindToShellToast();
        }
    }
    catch (Exception ex)
    {
        // handle error here
    }
 
    //////////////////////////////////////////
    // Bind to Tile Notification 
    //////////////////////////////////////////
    try
    {
        if (httpChannel.IsShellTileBound == true)
        {
            Trace("Already bounded (register) to Tile Notifications");
        }
        else
        {
            Trace("Registering to Tile Notifications");
 
            // you can register the phone application to receive tile images from remote servers [this is optional]
            Collection<Uri> uris = new Collection<Uri>();
            uris.Add(new Uri("http://jquery.andreaseberhard.de/pngFix/pngtest.png"));
 
            httpChannel.BindToShellTile(uris);
        }
    }
    catch (Exception ex)
    {
        //handle error here
    }
}

3. 現在找到 SubscribeToChannelEvents 函數並添加以下藍色反白程式碼片段到函數內：

(Code Snippet – Using Push Notifications – MainPage.xaml.cs – SubscribeToChannelEvents function body)

private void SubscribeToChannelEvents()
{
    //Register to UriUpdated event - occurs when channel successfully opens
   httpChannel.ChannelUriUpdated += new EventHandler<NotificationChannelUriEventArgs>(httpChannel_ChannelUriUpdated);  
 
   //Subscribed to Raw Notification
   httpChannel.HttpNotificationReceived += new EventHandler<HttpNotificationEventArgs>(httpChannel_HttpNotificationReceived);
 
   //general error handling for push channel
   httpChannel.ErrorOccurred += new EventHandler<NotificationChannelErrorEventArgs>(httpChannel_ExceptionOccurred);
   //subscrive to toast notification when running app    
   httpChannel.ShellToastNotificationReceived += new EventHandler<NotificationEventArgs>(httpChannel_ShellToastNotificationReceived);
}

4. 找到 Channel event handlers 區並添加以下事件處理函數：

(Code Snippet – Using Push Notifications – MainPage.xaml.cs – Tile and Toast notifications event handler function)

void httpChannel_ShellToastNotificationReceived(object sender, NotificationEventArgs e)
{ 
   Trace("===============================================");
   Trace("Toast/Tile notification arrived:");
   foreach (var key in e.Collection.Keys)
   {
      string msg = e.Collection[key];
 
      Trace(msg);
      Dispatcher.BeginInvoke(() => UpdateStatus("Toast/Tile message: " + msg));
   }
         
   Trace("===============================================");
}

注意：在我們這個簡單的案例中，函式只用來追蹤訊息封包，但是在真實世界的應用程式，你可以用它來執行任何的商業邏輯。

5. 最後添加以下程式碼片段到幾個位置：

(Code Snippet – Using Push Notifications – MainPage.xaml.cs – Subscribe toNotifications call)

SubscribeToNotifications();

添加此程式碼的位置：

a. 在 DoConnect 函數內的 try 塊中，位於 “SubscribeToService();” 和 “Dispatcher.BeginInvoke();” 之間：

if (null != httpChannel)
{
    Trace("Channel Exists - no need to create a new one");
    SubscribeToChannelEvents();
 
    Trace("Register the URI with 3rd party web service");
    SubscribeToService();
 
    Trace("Subscribe to the channel to Tile and Toast notifications");
    SubscribeToNotifications();
 
    Dispatcher.BeginInvoke(() => UpdateStatus("Channel recovered"));
}

b. 在 httpChannel_ChannelUriUpdated 函數內，“SubscribeToService();” 與 “Dispatcher.BeginInvoke(…);” 之間：

void httpChannel_ChannelUriUpdated(object sender, NotificationChannelUriEventArgs e)
{
    Trace("Channel opened. Got Uri:\n" + httpChannel.ChannelUri.ToString());
    Dispatcher.BeginInvoke(() => SaveChannelInfo());
    Trace("Subscribing to channel events");
    SubscribeToService();
    SubscribeToNotifications();
    Dispatcher.BeginInvoke(() => UpdateStatus("Channel created successfully"));
}

6. 按 F5 編譯並執行應用程式。在手機模擬器上，點擊Back 按鈕 ( ) 退出 Push Notification 應用程式並來到 Quick Launch 區域。

7. 在 Quick Launch 區域，點擊 Right Arrow 按鈕打開“All Applications” 螢幕。

圖 37
打開應用程式螢幕

8. 找到 PushNotifications，按下並保持直到快顯功能表彈出，點擊 Pin to Start 附加到快速啟動區域。

圖 38
附加 tile 到開始螢幕

9. 模擬器會自動回到Quick Launch 區域，這裡你可以看到 PushNotifications tile 已被附加到此區域。

圖 39
PushNotifications Tile

10. 在 WPF Push Notification Client 上，修改通知參數然後點擊 Send Tile 按鈕。觀察模擬器上的Tile 變化。如果你點擊Toast消息你會被帶回到這個應用程式。

圖 40
Tile Notification 到達模擬器

11. 在 WPF Push Notification Client 上輸入一些消息然後點擊 Send Toast 按鈕。觀察 Toast 消息如何到達手機。點擊這個Toast 消息會切換到該應用程式。

圖 41
手機模擬器上的 Toast 消息

圖 42
Windows Phone 應用程式上的 Toast 消息

本任務到此為止。

任務 3 – 在手機上處理預定的 Tile Notifications

注意：您也可以使用 Microsoft.Phone.Shell.ShellTileSchedule 類提供的 shell tile 預定來更新應用程式的 tile。這種特殊的類別允許應用程式定期對其 tile 背景圖像更新，透過設置背景圖像的完整 URI 和相關的重複時間間隔屬性即可完成。當手機啟動 tile 預定實例，它會自動發送一個 tile 通知到應用程式，然後根據 URI 提取圖像，並更新 tile。

接下來的幾步你會建立一個 ShellTileSchedule 類的實例，並執行應用程式的 tile 更新。

1. 打開 PushNotifications 專案中的 App.xaml.cs。

2. 找到應用程式的建構式－ App 方法，然後緊隨其後插入以下程式碼片段：

(Code Snippet – Using Push Notifications – MainPage.xaml.cs – CreateShellTileScheduleFunction)

// To store the instance for the application lifetime
private ShellTileSchedule shellTileSchedule;
 
  /// <summary>
  /// Create the application shell tile schedule instance
  /// </summary>
  private void CreateShellTileSchedule()
  {
      shellTileSchedule = new ShellTileSchedule();
      shellTileSchedule.Recurrence = UpdateRecurrence.Interval;
      shellTileSchedule.Interval = UpdateInterval.EveryHour;
      shellTileSchedule.StartTime = DateTime.Now;
      shellTileSchedule.RemoteImageUri = new   Uri(@"http://cdn3.afterdawn.fi/news/small/windows-phone-7-series.png");
      shellTileSchedule.Start();
  }

注意：你只能提供一個 RemoteImageUri。因此你必須提供一個連線並且有效的 URI 來提供圖片下載並顯示，你不能引用本地應用程式的 URI。圖像大小不能超過 80KB，並且下載時間不能超過 60 秒。

3. 現在，找到 App() 函數並從這裡叫用 CreateShellTileSchedule 函數 (參照反白的程式碼行)：

(Code Snippet – Using Push Notifications – MainPage.xaml.cs – CreateShellTileScheduleFunction)

// Constructor
public App()
{
    // Global handler for uncaught exceptions. 
    // Note that exceptions thrown by ApplicationBarItem.Click will not get caught here.
    UnhandledException += Application_UnhandledException;
 
    // Standard Silverlight initialization
    InitializeComponent();
 
    // Phone-specific initialization
    InitializePhoneApplication();
 
    // Create the shell tile schedule instance
    CreateShellTileSchedule();
}

你剛剛提供了一個物件，它會根據 schedule 屬性更新應用程式的 tile。

你需要設置以下屬性：

Recurrent，設置其值為 Interval，這可以使 tile 定期更新。這個屬性的另一個可設置值為OneTime，tile 的更新只發生一次。
Interval，設置為 EveryHour，可以使 tile 每 60 分鐘更新一次。需要提一下的是一小時是可以設置的最小更新間隔，這個規定是為了節約手機資源。
RemoteImageUri，設置為你可以獲取圖像的位址。

最後，你需要叫用 Start 方法啟動更新 tile。請注意，第一次更新可能會延遲一小時，因為這個類別會整個小時地叫用更新。即使您設置開始時間為現在，你也需要等待手機每隔 60 分鐘發生一次的更新。不幸的是，這是一個系統級的限制，所以如果你要除錯的程式碼，你必須等一個小時。

4. 按 F5 編譯並執行應用程式。在手機模擬器上點擊 Back 按鈕 ( ) 退出Push Notification 應用，並回到 Quick Launch 區域.

5. 確認一下你的應用程式 tile 被附加到Quick Launch 區域，否則按照 Task 2 的第 7-9 步附加它。

6. PushNotifications tile 圖像現在會根據 ShellTileSchedule 的定義進行更新。因此當第一個時間間隔過去之後的下一個小時，應用程式的 tile 會顯示來自 RemoteImageUri 屬性中所示位址的圖像，http://cdn3.afterdawn.fi/news/small/windows-phone-7-series.png。

圖 43
Scheduled Tile Image

本練習和本實驗到此結束。

原文地址：http://msdn.microsoft.com/zh-tw/windowsphone/gg471245.aspx；