範本

發行項
11/09/2015

範本可讓用戶端應用程式指定它要接收的確切通知格式。使用範本時，app 可以獲得數個不同的好處，包括下列各項：

與平臺無關的後端。
個人化通知。
用戶端版本獨立性。
輕鬆當地語系化。

本節提供兩個深入的範例，說明如何使用範本來傳送以您在所有平台的所有裝置為目標的跨平台通知，以及如何針對每部裝置將廣播通知個人化。

使用範本跨平臺

傳送推播通知的標準方式是，針對要傳送的每個通知，傳送一個特定的承載給平台通知服務 (WNS、APNS)。例如，若要傳送警示給 APNS，則承載會是形式如下的 JSON 物件：

{“aps”: {“alert” : “Hello!” }}

若要在Windows Microsoft Store應用程式上傳送類似的快顯通知訊息，承載如下所示：

<toast>
  <visual>
    <binding template=\"ToastText01\">
      <text id=\"1\">Hello!</text>
    </binding>
  </visual>
</toast>

您可以為 MPNS (Windows Phone) 和 GCM (Android) 平台建立類似的承載。

這項要求會強制 app 後端為每個平台產生不同的承載，而有效地讓後端負責 app 展示層的一部分。一些考量包括當地語系化和圖形配置 (尤其是針對包含各種類型之磚通知的「Windows 市集」應用程式)。

「通知中樞」範本功能可讓用戶端 app 建立特殊的註冊 (稱為範本註冊)，其中除了包含一組標記之外，還包含一個範本。在前述的承載範例中，唯一的平台獨立資訊是實際的警示訊息 (Hello!)。範本是「通知中樞」的一組指示，有關如何針對該特定用戶端 app 的註冊，設定平台獨立訊息的格式。在前述範例中，平台獨立訊息是一個單一屬性： message = Hello!。

下圖說明上述的程序：

Templates

iOS用戶端應用程式註冊的範本如下所示：

{“aps”:{“alert”:”$(message)”}}

Windows Microsoft Store用戶端應用程式的類似範本如下：

<toast>
  <visual>
    <binding template=\"ToastText01\">
      <text id=\"1\">$(message)</text>
    </binding>
  </visual>
</toast>

請注意，實際的訊息會取代運算式 $(message) 。此運算式會指示通知中樞，每當訊息傳送至此特定註冊時，即可建置遵循此範本的訊息。

用戶端應用程式可以建立多個註冊，以使用多個範本;例如，警示訊息的範本，以及磚更新的範本。用戶端應用程式也可以混合使用原生註冊 (無範本的註冊) 與範本註冊。

注意

通知中樞會針對每個註冊傳送一個通知，而不考慮它們是否屬於相同的用戶端應用程式。這種行為可用來將平台獨立通知轉譯成更多的通知。例如，對「通知中樞」而言相同的平台獨立訊息可以順暢地在快顯通知警示與磚更新中轉譯，而不需要後端知道它。請注意，某些平台 (例如 iOS) 可能會將在短時間內傳送給相同裝置的多個通知摺疊起來。

使用個人化範本

使用範本的另一個好處是能夠使用「通知中樞」依每一註冊執行通知個人化。例如，假設有一個天氣 app，此 app 會顯示含有特定位置天氣狀況的磚。使用者可以在攝氏或華氏溫度及單日或五日預測之間做選擇。使用範本時，每個用戶端 app 安裝項可以註冊所需的格式 (1 日攝氏、1 日華氏、 5 日攝氏、 5 日華氏)，然後讓後端傳送一個含有填寫這些範本 (例如，使用攝氏和華氏溫度的 5 日預報) 所需之一切資訊的單一訊息。

使用攝氏溫度的 1 日預報範本如下：

<tile>
  <visual>
    <binding template="TileWideSmallImageAndText04">
      <image id="1" src="$(day1_image)" alt="alt text"/>
      <text id="1">Seattle, WA</text>
      <text id="2">$(day1_tempC)</text>
    </binding>  
  </visual>
</tile>

傳送至通知中樞的訊息包含下列屬性：

Day1_image
Day1_tempC
Day1_tempF
Day2_image
Day2_tempC
…

藉由使用此模式，後端只需傳送單一訊息，而不需儲存 app 使用者的特定個人化選項。下圖說明這個案例：

Templates

如何註冊範本

如需如何註冊範本的詳細資訊，請參閱註冊管理。

範本運算式語言

範本不能包含字串。它們僅限於 XML 或 JSON 檔。此外，您只能將運算式放在特定的位置；例如，如果是 XML，只能放在節點屬性或值中，如果是 JSON，則只能放在字串屬性值中。

例如，以下的 XML 範本無效：

<tile>
  <visual>
    <binding $(property)>
      <text id="1">Seattle, WA</text>
    </binding>  
  </visual>
</tile>

如下一節所述，使用串連時，運算式必須包裝在大括弧中。例如：

<tile>
  <visual>
    <binding template="ToastText01">
      <text id="1">{'Hi, ' + $(name)}</text>
    </binding>  
  </visual>
</tile>

JSON 中的類似程式碼如下所示：

{"aps":{"alert":"{'Hi, ' + $(name)}"}}

下表顯示範本中允許使用的語言：

運算式	描述
`$(prop)`	具有指定名稱之事件屬性的參考。屬性名稱不區分大小寫。如果屬性不存在，這個運算式就會解析成屬性的文字值或空字串。
`$(prop, n)`	如上所述，但文字會明確裁剪為 n 個字元，例如 `$(title, 20)` 將 title 屬性的內容裁剪為 20 個字元。
`.(prop, n)`	同上，但文字會在裁剪之後，後面加上三個點。裁剪的字串與字尾的總大小不會超過 n 個字元。 `.(title, 20)` 具有「This is the title line」的輸入屬性會產生此標題...。
`%(prop)`	`$(name)`類似于，輸出是 URI 編碼。
#(prop)	用於 JSON 範本 (例如，用於 iOS 與 Android 範本)。此函式的運作方式與先前指定的完全相同 `$(prop)` ，不同之處在于 JSON 範本 (使用時，例如 Apple 範本) 。在此情況下，如果此函式未以「{'，'}」括住 (`‘myJsonProperty’ : ‘#(name)’)` 例如，而且它會評估為 JAVAscript 格式的數位，例如 `regexp: (0\|([1-9][0-9]*))(\.[0-9]+)?((e\|E)(+\|-)?[0-9]+)?` ，則輸出 JSON 為數字。例如， `‘badge : ‘#(name)’` 會變成 `‘badge’ : 40` (，而不是 `‘40‘`) 。
`‘text’ or “text”`	常值。常值包含以單引號或雙引號括住的任意文字。
`expr1 + expr2`	將兩個運算式聯結成單一字串的串連運算子運算式可以是前述任一形式。使用串連時，整個運算式必須包含在 `{}` 中。例如： `{$(prop) + ‘ - ’ + $(prop2)}` 。

共用方式為

範本

使用範本跨平臺

使用個人化範本

如何註冊範本

範本運算式語言

其他資源