WNS 通知の優先順位WNS Notification Priorities

WNS POST メッセージを通知の優先度が単純なヘッダーを設定して、バッテリの機密性の高い状況で通知を配信する方法を制御できます。By setting a notification's priority with a simple header to WNS POST messages, you can control how notifications are delivered in battery sensitive situations.

Windows の電源を入れますPower on Windows

多くのユーザーが、バッテリ電源デバイスでのみ作業している、電力使用量を最小限に抑えることと、すべてのアプリの標準の要件になっています。As more users are working only on battery powered devices, minimizing power usage has become a standard requirement for all apps. アプリに提供される値よりも多くのエネルギーを消費する場合、ユーザーは、アプリをアンインストール可能性があります。If apps consume more energy than the value they provide, users might uninstall the apps. Windows オペレーティング システムでは、可能であれば、バッテリの電力使用量が減りますが、中には効率的に作業アプリの責任です。While the Windows operating system reduces power usage on the battery where possible, it is the app's responsibility to work efficiently.

WNS の優先順位は、バッテリ電源の重要ではない作業を移動する 1 つの方法です。WNS priorities is one way to move non-critical work off the battery. WNS の優先順位は、システムに通知をすぐに配信して、デバイスが電源に接続されているまでに待機することができますを指示します。The WNS priorities tell the system which notifications should be delivered instantly and which can wait until the device is plugged into a power source. これらのヒントを使用して、システムは、正確な時間は、ユーザーとアプリの両方に最も重要な通知を配信できます。With these hints, the system can deliver the notifications the exact time they are the most valuable to both the user and the app.

デバイスの電源モードPower modes on the device

すべての Windows デバイスの電源モード (バッテリ、バッテリの省電力、および料金) のさまざまなを通じて動作し、ユーザーが別の電源モードでアプリからのさまざまな動作を期待します。Every Windows device operates through a variety of power modes (battery, battery saver, and charge), and users expect different behaviors from apps in different power modes. デバイスがオンのすべての通知を送信する必要があります。When the device is on, all notifications should be delivered. バッテリー節約機能モードでは、最も重要な通知のみを配信する必要があります。In battery saver mode, only the most important notifications should be delivered. デバイスを接続には、同期または非時間の重要な操作を完了することができます。While the device is plugged in, sync or non-time critical operations can be completed.

Windows では、システムは、通知の適切な優先順位を設定するアプリに完全に依存するため、通知がすべてのユーザーまたはアプリにとって重要なを認識しません。Windows does not know which notifications are important to any user or app, so the system relies totally on apps to set the right priority for their notifications.

優先順位Priorities

次の 4 つの優先順位はプッシュ通知を送信するときに使用するアプリを使用できます。There are four priorities available for an app to use when sending push notifications. 個々 の通知、通知をすぐに配信する必要がありますを選択することができます (IM メッセージなど) およびどれが待機できる優先度を設定 (写真の更新プログラムの連絡先など)。The priority is set on individual notifications, allowing you to choose which notifications need to be delivered instantly (e.g., an IM message) and which ones can wait (e.g., contact photo updates).

優先順位は次のとおりです。The priorities are:

PriorityPriority ユーザーの上書きUser Override 説明Description Example
High [はい] – ユーザーはアプリからのすべての通知をブロックできますか、バッテリー節約機能モードで調整されているアプリを防止できます。Yes – user can block all notifications from an app OR can prevent an app from being throttled in battery saver mode. 配信されるすぐにどのような状況で、デバイスが通知を受信するときに最も重要な通知です。The most important notifications that must be delivered right away in any circumstance when the device can receive notifications. などの VoIP 通話またはデバイスのスリープを解除する必要があります重大なアラートがこのカテゴリに分類されます。Things like VoIP calls or critical alerts that should wake the device fall into this category. VoIP 通話、時間、重大なアラートVoIP calls, time- critical alerts
Medium [はい] – ユーザーはアプリからのすべての通知をブロックできますか、バッテリー節約機能モードで調整されているアプリを防止できます。Yes – user can block all notifications from an app OR can prevent an app from being throttled in battery saver mode. これらは、すぐに実行する必要はありませんが、重要なものとないものが、バック グラウンドで実行されていない場合、ユーザーがしかめ面とします。These are things that are not as important, things that don’t need to happen right away, but users would be annoyed if they are not running in the background. 電子メール アカウントの同期セカンダリ、ライブ タイルを更新します。Secondary Email account sync, live tile updates.
Low [はい] – ユーザーはアプリからのすべての通知をブロックできますか、バッテリー節約機能モードで調整されているアプリを防止できます。Yes – user can block all notifications from an app OR can prevent an app from being throttled in battery saver mode. 意味のあるのみ、ユーザーがデバイスを使用するとき、またはバック グラウンド アクティビティが意味を通知します。Notifications that only make sense when the user is using the device or when background activity makes sense. キャッシュはされ、ユーザーのサインインまたはプラグインするときに自分のデバイスにまで処理されません。These are cached and not processed until the user signs in or plugs in their device. 連絡先の状態 (オンラインまたはオフライン)Contact status (online/offline)
非常に低いVery Low [いいえ] –、バッテリー節約機能モードで調整されているから通知を非常に低優先度を防ぐことはできません。No – It cannot prevent very low priority notifications from being throttled in battery saver mode. これはほぼ同じように優先度の低いユーザー以外は、バッテリー セーバー ポリシーをオーバーライドできません。This is almost the same as low priority except users cannot override the battery saver policy. これらの通知は、決してバッテリー セーバーで配信されます。These notifications will never be delivered in battery saver. 同期サービスのファイルを同期します。Syncing files for a sync service.

多くのアプリが通知のライフ サイクルを通じて異なる優先度を持つことに注意してください。Note that many apps will have notifications of different priority throughout their lifecycle. 優先順位が-通知ごとに設定されているためこれは問題になりません。Since the priority is set on a per-notification basis, this isn’t an issue. VoIP アプリでは、着信呼び出しの優先度の高い通知を送信でき、その後、低優先度のいずれかの連絡先がオンラインにすることができます。A VoIP app can send a high priority notification for an incoming call and then follow it up with a low priority one when a contact comes online.

優先順位の設定Setting the priority

通知要求の優先順位の設定は、POST 要求に追加のヘッダーによって行われますX-WNS-PRIORITYします。Setting the priority on the notification request is done through an additional header on the POST request, X-WNS-PRIORITY. これは、優先順位にマップする 0 ~ 3 の整数値です。This is an integer value between 0 and 3 which maps to a priority:

優先度の名前Priority Name 優先順位 WNS X の値X-WNS-PRIORITY Value 既定値:Default for:
High 11 トーストToasts
MeduimMeduim 22 タイルとバッジTiles and Badges
Low 33 直接Raw
非常に低いVery Low 44

ある旧バージョンと互換性がある、優先度の設定は必要ありません。To be backward compatible, setting a priority is not required. 場合に、アプリは、通知の優先順位で設定されていない、システムは既定の優先順位を提供します。In case an app doesn’t set the priority of their notifications, the system will provide a default priority. 既定値はの上側にグラフで表示され、Windows の既存のバージョンの動作と一致させます。The defaults are shown in the chart above and match the behavior of existing versions of Windows.

デスクトップの動作の詳細な一覧Detailed listing of desktop behavior

Windows 多く異なる Sku 間で、アプリを配布する場合は、前のセクションで、グラフに通常お勧めします。If you are shipping your app across many different SKUs of Windows, it is normally best to follow the chart in the above section.

優先順位ごとより具体的な推奨される動作は、以下に示します。More specific recommended behaviors for each priority are listed below. 各デバイスは、グラフに従って正確に動作する保証はありません。This is not a guarantee that each device will work exactly according to the chart. Oem は、異なる動作を構成する自由がありますが、ほとんどは、このグラフの近くにします。OEMs are free to configure the behavior differently, but most are close to this chart.

デバイスの状態Device State 優先順位:高PRIORITY: High 優先順位:中PRIORITY: Medium 優先順位:低PRIORITY: Low 優先順位:非常に低いPRIORITY: Very Low
画面上または電源に接続Screen On OR plugged in 配信Deliver 配信Deliver 配信Deliver 配信Deliver
画面オフとバッテリ使用時Screen Off AND on battery 配信Deliver ユーザーを除外する場合: その他の配信: バッチIf user exempted: deliver Else: batch ユーザーを除外する場合: その他の配信: キャッシュ *If user exempted: deliver Else: cache * キャッシュCache
バッテリー セーバーを有効になっています。Battery Saver enabled ユーザーを除外する場合: その他の配信: キャッシュIf user exempted: deliver Else: cache ユーザーを除外する場合: その他の配信: キャッシュIf user exempted: deliver Else: cache ユーザーを除外する場合: その他の配信: キャッシュIf user exempted: deliver Else: cache キャッシュCache
バッテリ + バッテリー セーバーを有効になっている + スクリーンOn battery + battery saver enabled + screen off ユーザーを除外する場合: その他の配信: キャッシュIf user exempted: deliver Else: cache ユーザーを除外する場合: その他の配信: キャッシュIf user exempted: deliver Else: cache ユーザーを除外する場合: その他の配信: キャッシュIf user exempted: deliver Else: cache キャッシュCache

オフ、既定では画面の優先度の低い通知が配信されると Windows Phone にはバッテリ ベースのデバイス。Note that low priority notifications will be delivered by default for screen off and battery only for Windows Phone based devices. MPNS の既存のポリシーとの互換性を maintian ではありません。This is to maintian compatibility with preexisting MPNS policy. 4 番目と 5 番目の行が同じである、さまざまなシナリオを呼び出す前にも注意してください。Also note that the fourth and fifth rows are the same, just calling out different scenarios.

バッテリー セーバーでのアプリを除外するには、ユーザー必要があります、"バッテリ使用量で"設定でアプリに移動して選択「許可アプリをバック グラウンド タスクを実行します」To exempt an app in battery saver, users must go to the "Battery Usage by App" in Settings and select "Allow the app to run background tasks." このユーザーの選択は、高、中、低優先度の通知のバッテリー セーバーからアプリを除外します。This user selection exempts the app from battery saver for high, medium, and low priority notifications. 呼び出すこともできますBackgroundExecutionManager APIをプログラムで、ユーザーのアクセス許可を要求します。You can also call BackgroundExecutionManager API to programatically ask for the user's permission.