Notification Hubs テンプレート
テンプレートを使用すると、クライアント アプリケーションで受信する通知の正確な形式を指定できます。 テンプレートを使用すると、アプリは、次のようないくつかの異なる利点を実現できます。
- プラットフォームに依存しないバックエンド
- 個人用に設定された通知
- クライアント バージョンへの非依存性
- 容易なローカライズ
このセクションでは、テンプレートの使い方について 2 つの詳細な例を紹介します。1 つはあらゆるプラットフォームのデバイスに対してプラットフォーム非依存の通知を送信する方法、もう 1 つは、ブロードキャスト通知を各デバイス向けに個人用に設定する方法です。
クロスプラット フォームでのテンプレートの使用
プッシュ通知を送信する標準的な方法は、送信する通知ごとに固有のペイロードをプラットフォーム通知サービス (WNS、APNS) に送信することです。 たとえば、APNS にアラートを送信する場合、ペイロードは次の形式の JSON オブジェクトです。
{"aps": {"alert" : "Hello!" }}
Windows ストア アプリケーションで同様のトースト メッセージを送信する場合、XML ペイロードは次のようになります。
<toast>
<visual>
<binding template=\"ToastText01\">
<text id=\"1\">Hello!</text>
</binding>
</visual>
</toast>
同様のペイロードを MPNS (Windows Phone) プラットフォームと FCM (Android) プラットフォーム用にも作成できます。
この要件により、アプリ バックエンドではプラットフォームごとに異なるペイロードを生成する必要があり、必然的にバックエンドがアプリのプレゼンテーション層の一部を担うことになります。 これにより、ローカリゼーションとグラフィック レイアウトの問題が生じます (さまざまな種類のタイル用の通知を含む Windows ストア アプリの場合は特にそうです)。
Notification Hubs のテンプレート機能を使用すると、クライアント アプリでテンプレート登録と呼ばれる特別な登録を作成できます。この登録には、タグのセットに加えて、テンプレートが含まれます。 Notification Hubs のテンプレート機能を使用すると、インストール (推奨) または登録のどちらを操作している場合でも、クライアント アプリでデバイスをテンプレートに関連付けることができます。 先ほどのペイロードの例では、プラットフォームに依存しない情報は、実際のアラート メッセージ (Hello! ) だけです。 テンプレートは、通知ハブに対する一連の命令であり、該当する特定のクライアント アプリの登録に対してプラットフォームに依存しないメッセージを形成する方法を指示します。 前の例で、プラットフォームに依存しないメッセージは message = Hello! という 1 つのプロパティです。
次の図はプロセスを示しています。
iOS クライアント アプリ登録用のテンプレートは次のとおりです。
{"aps": {"alert": "$(message)"}}
Windows ストア クライアント アプリ用の同様のテンプレートは次のとおりです。
<toast>
<visual>
<binding template=\"ToastText01\">
<text id=\"1\">$(message)</text>
</binding>
</visual>
</toast>
実際のメッセージが $(message) という式に置き換えられていることに注目してください。 この式は、通知ハブが該当する登録にメッセージを送信するたびに、このテンプレートに従っており共通の値を挿入するメッセージを構築するよう通知ハブに指示します。
インストール モデルで作業している場合、インストールの "templates" キーには複数のテンプレートから成る JSON が保持されています。 登録モデルで作業している場合、クライアント アプリケーションでは、アラート メッセージ用のテンプレートやタイル更新用のテンプレートなど複数のテンプレートを使用するように、複数の登録を作成することができます。 また、ネイティブ登録 (テンプレートなしの登録) とテンプレート登録を組み合わせることもできます。
通知ハブは、同じクライアント アプリに属するかどうかを考慮せずに、テンプレートごとに 1 つの通知を送信します。 この動作を使用して、プラットフォームに依存しない通知を多数の通知に変換することができます。 たとえば、通知ハブへのプラットフォームに依存しない同じメッセージは、バックエンドに認識させることなく、トースト アラートやタイル更新でシームレスに変換できます。 一部のプラットフォーム (iOS など) では、短期間に送信される場合、同じデバイスへの複数の通知が折りたたまれることがあります。
テンプレートを使用した個人用設定
テンプレートを使用することのもう 1 つのメリットは、Notification Hubs を使用して、登録ごとに通知の個人用設定を行うことができる点です。 たとえば、特定の場所の天候を示したタイルを表示する天気アプリがあるとします。 ユーザーは、摂氏または華氏、1 日分の予報または 5 日分の予報を選択できます。 テンプレートを使用すると、インストールされたクライアント アプリごとに必要な形式を登録し (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 | day2_image | day3_image | day4_image | day5_image |
|---|---|---|---|---|
| day1_tempC | day2_tempC | day3_tempC | day4_tempC | day5_tempC |
| day1_tempF | day2_tempF | day3_tempF | day4_tempF | day5_tempF |
このパターンを使用すると、バックエンドは単一のメッセージを送信するだけでよく、アプリ ユーザーのための特定の個人用設定オプションを格納する必要はありません。 このシナリオを次の図に示します。
テンプレートを登録する方法
インストール モデル (推奨) または登録モデルを使用してテンプレートを登録する方法については、「登録管理」を参照してください。
テンプレートの式言語
テンプレートで使用できるのは XML または JSON ドキュメント形式のみです。 また、式を配置できる場所も決まっています。XML の場合はノード属性または値、JSON の場合は文字列プロパティ値です。
次の表に、テンプレートで使用できる言語を示します。
| 式 | 説明 |
|---|---|
| $ (prop) | 指定された名前のイベント プロパティを参照します。 プロパティ名では、大文字と小文字は区別されません。 この式は、プロパティのテキスト値に解決されます。ただし、プロパティが存在しない場合は空の文字列に解決されます。 |
| $(prop, n) | 上記と同じですが、テキストは明示的に n 文字に省略されます。たとえば $(title, 20) は title プロパティの内容を 20 文字に省略します。 |
| .(prop, n) | 上記と同じですが、テキストが省略されているので、テキストに 3 つのドットのサフィックスが付いています。 省略された文字列とサフィックスの合計サイズは n 文字以下です。(title, 20) で入力プロパティが "This is the title line" である場合、結果は This is the title... になります。 |
| %(prop) | 出力が URI エンコードされる点を除き、$(name) と同様です。 |
| #(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)' は ('40'ではなく) 'badge' : 40 になります。 |
| 'text' または "text" | リテラルです。 リテラルは、一重引用符または二重引用符で囲んだ任意のテキストを保持します。 |
| expr1 + expr2 | 2 つの式を結合して 1 つの文字列にする連結演算子です。 |
上記のどの形式でも使用できます。
連結を使用している場合は、式全体を {} で囲む必要があります。 たとえば、「 {$(prop) + ‘ - ’ + $(prop2)} 」のように入力します。
たとえば、次のテンプレートは有効な 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>