定期的な通知の概要

2025-07-29

定期的な通知。ポーリング通知とも呼ばれ、クラウドサービスからコンテンツをダウンロードして、タイルとバッジを一定の間隔で更新します。定期的な通知を使うには、クライアントアプリのコードで 2 つの情報を指定する必要があります。

Windows がアプリのタイルやバッジを更新するために使用するウェブ上の場所の URI (Uniform Resource Identifier)
URI をポーリングする頻度

定期的な通知では、最小限のクラウドサービスとクライアントの投資で、ライブタイルを更新することができます。定期的な通知は、同じコンテンツを多数のユーザーに配信する優れた方法です。

注: 詳細については、Windows 8.1 用のプッシュ通知と定期的な通知のサンプルをダウンロードし、そのソースコードを Windows 10 アプリで再利用することで確認できます。

動作方法

定期的な通知では、アプリでクラウドサービスをホストする必要があります。このサービスは、アプリをインストールしているすべてのユーザーによって定期的にポーリングされます。 Windows では、ポーリング間隔 (1 時間に 1 回など) に従って URI に HTTP GET 要求を送り、この要求に対する応答として提供される要求したタイルまたはバッジのコンテンツ (XML 形式) をダウンロードして、アプリのタイルにそのコンテンツを表示します。

定期的な更新はトースト通知では使用できないことに注意してください。トーストは、スケジュールされた通知またはプッシュ通知で配信するのが最適な方法です。

URI の場所と XML コンテンツ

ポーリングする URI には、HTTP や HTTPS の有効な Web アドレスを使うことができます。

クラウドサーバーからの応答には、ダウンロードされたコンテンツが含まれます。 URI から返されるコンテンツは、タイルまたはバッジの XML スキーマの仕様に準拠し、UTF-8 の形式でエンコードされている必要があります。仕様で規定されている HTTP ヘッダーを使うと、通知の有効期限やタグを指定することができます。

Polling Behavior

ポーリングを開始するには次のメソッドのいずれかを呼び出します。

これらのいずれかのメソッドを呼び出すと、URI がすぐにポーリングされて、受け取ったコンテンツでタイルやバッジが更新されます。この最初のポーリングの後は、要求した間隔で更新が提供されます。ポーリングは、を使って TileUpdater.StopPeriodicUpdateで明示的に停止するか、アプリがアンインストールされるか、セカンダリタイルの場合はタイルが削除されるまで続行されます。それまでの間は、アプリが起動されなくても、タイルやバッジの更新がないかどうかを調べるために継続的にポーリングが行われます。

繰り返し間隔

繰り返し間隔は、上記のメソッドのパラメーターとして指定します。 Windows は要求された間隔でポーリングを適切に実行しますが、多少の誤差が生じる場合もあります。 Windows の判断により、要求したポーリング間隔よりも最大で 15 分ほど遅れる可能性があります。

開始時刻

必要に応じて、ポーリングを開始する時刻を指定できます。タイルのコンテンツが 1 日に 1 回しか変更されないようなアプリでは、ポーリングの開始時刻をクラウドサービスの更新時刻の直後に設定することをお勧めします。たとえば、毎日のショッピングサイトが午前8時にオファーを発行する場合、午前8時過ぎに新しいタイルコンテンツをチェックします。

開始時刻を指定した場合、メソッドを最初に呼び出したときに、すぐにポーリングが行われコンテンツが確認されます。それ以降の定期的なポーリングは、指定した開始時刻の 15 分以内に開始されます。

自動再試行動作

URI がポーリングされるのは、デバイスがオンラインになっている場合だけです。ネットワークが利用可能でも、任意の理由で URI にアクセスできない場合は、ポーリング間隔の反復が 1 回スキップされ、次の間隔で再び URI がポーリングされます。ポーリング間隔に達したときにデバイスがオフ、スリープ、または休止状態になっていた場合、URI は、デバイスがオフ状態やスリープ状態から回復したときにポーリングされます。

アプリの更新プログラムの処理

ポーリング URI を変更するアプリの更新プログラムをリリースする場合は、タイルが必ず新しい URI を使用するように、新しい URI と共に StartPeriodicUpdate を呼び出す、毎日の時刻のトリガーによるバックグラウンドタスクを追加する必要があります。そうしないと、ユーザーがアプリの更新プログラムを受け取ってもアプリを起動しない場合、ユーザーのタイルは古い URI を使い続けるため、URI が無効になった場合や返されたペイロードが存在しないローカル画像を参照している場合に、表示に失敗することがあります。

タイルとバッジ通知の有効期限

既定では、定期的なタイル通知とバッジ通知は、ダウンロードされたときから 3 日後に有効期限切れになります。通知の有効期限が切れると、バッジ、タイル、キューからコンテンツが削除され、ユーザーに表示されなくなります。すべての定期的なタイル通知とバッジ通知には、アプリや通知に適した時間を使って有効期限を明示的に設定し、コンテンツの意味がなくなっても保持されないようにすることをお勧めします。明示的な有効期限は、コンテンツの存続期間が決まっている場合に重要です。また、クラウドサービスにアクセスできなくなった場合や、ユーザーがネットワークに長時間接続していない場合に、古いコンテンツが確実に削除されます。

クラウドサービスでは、応答のペイロードに X-WNS-Expires HTTP ヘッダーを含めることによって、通知の有効期限の日時が明示的に設定されます。 X-WNS-Expires HTTP ヘッダーは、HTTP-date 形式に準拠します。詳細については、「StartPeriodicUpdate または StartPeriodicUpdateBatch」を参照してください。

たとえば、株式市場の取引が活発な日は、株価の更新の有効期限をポーリング間隔の有効期限の 2 倍に設定することをお勧めします (ポーリング間隔が 30 分の場合は有効期限を受け取り後 1 時間にするなど)。別の例として、ニュースアプリでは、1 日のニュースタイルの更新に適した有効期限が 1 日であると判断される場合があります。

通知キューでの定期的な通知

定期的なタイルの更新は、通知の循環で使用できます。既定では、スタート画面のタイルには、新しい通知によって置き換えられるまで、1 つの通知のコンテンツが表示されます。循環を有効にすると、最大で 5 つの通知がキューに入れられ、タイルに循環して表示されます。

キューの通知の数が限度の 5 個になると、次の新しい通知によってキューの最も古い通知が置き換えられます。ただし、通知にタグを設定することで、キューの置き換えポリシーを操作できます。タグは大文字と小文字が区別されないアプリ固有の文字列 (最大 16 文字の英数字) で、応答のペイロードの X-WNS-Tag HTTP ヘッダーで指定されます。着信した通知のタグは、既にキューにあるすべての通知のタグと比較され、一致するものが見つかると、キューにある同じタグを持つ通知が新しい通知に置き換えられます。一致するものが見つからない場合は、既定の置き換え規則が適用され、キューの最も古い通知が新しい通知に置き換えられます。

通知のキューとタグを使うと、充実した通知シナリオを実装できます。たとえば、株価アプリでは、それぞれの銘柄名をタグに使って異なる 5 銘柄の通知を送ることができます。これにより、同じ在庫に対して、古くなった通知を含めてキューに2つの通知が含まれることが防止されます。

詳しくは、「通知キューの使用」をご覧ください。

通知キューの有効化

通知キューを実装するには、最初に、タイルに対してキューを有効にする必要があります (「ローカル通知で通知キューを使用する方法」を参照)。キューを有効にする呼び出しはアプリの存続期間で 1 回だけ実行する必要がありますが、アプリが起動されるたびに呼び出しても問題はありません。

一度に複数件の通知を定期的に確認する

Windows でダウンロードを行うタイルの通知ごとに、一意の URI を指定する必要があります。 StartPeriodicUpdateBatch メソッドを使うと、通知キューで使う URI を一度に 5 つまで指定できます。各 URI がポーリングされ、ほぼ同じ時間にそれぞれ 1 つの通知ペイロードが返されます。ポーリングされる各 URI からは、それぞれ固有の有効期限とタグ値を返すこともできます。