WNS-Benachrichtigungs PrioritätenWNS Notification Priorities

Durch Festlegen der Priorität einer Benachrichtigung mit einem einfachen Header auf WNS-Post-Nachrichten können Sie steuern, wie Benachrichtigungen in Akku sensiblen Situationen zugestellt werden.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.

Einschalten von FensternPower on Windows

Da mehr Benutzer nur auf Akku Geräten arbeiten, ist das Minimieren des Energieverbrauchs zu einer Standard Anforderung für alle apps geworden.As more users are working only on battery powered devices, minimizing power usage has become a standard requirement for all apps. Wenn apps mehr Energie beanspruchen als der von Ihnen bereitgestellte Wert, können Benutzer die apps deinstallieren.If apps consume more energy than the value they provide, users might uninstall the apps. Wenngleich das Windows-Betriebssystem die Stromversorgung für den Akku nach Möglichkeit reduziert, ist es für die APP verantwortlich, effizient zu arbeiten.While the Windows operating system reduces power usage on the battery where possible, it is the app's responsibility to work efficiently.

WNS-Prioritäten sind eine Möglichkeit zum Verschieben nicht kritischer Arbeit aus dem Akku.WNS priorities is one way to move non-critical work off the battery. Die WNS-Prioritäten teilen dem System mit, welche Benachrichtigungen umgehend zugestellt werden sollten und wie gewartet werden kann, bis das Gerät an eine Stromquelle angeschlossen ist.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. Mit diesen hinweisen kann das System die Benachrichtigungen genau so bereitstellen, wie Sie für den Benutzer und die APP am nützlichsten sind.With these hints, the system can deliver the notifications the exact time they are the most valuable to both the user and the app.

Energie Modi auf dem GerätPower modes on the device

Jedes Windows-Gerät wird über eine Vielzahl von Energie Modi betrieben (Akku, Akku Schoner und Belastung), und Benutzer erwarten verschiedene Verhaltensweisen von apps in unterschiedlichen Energie Modi.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. Wenn das Gerät eingeschaltet ist, sollten alle Benachrichtigungen übermittelt werden.When the device is on, all notifications should be delivered. Im Akku Spar Modus sollten nur die wichtigsten Benachrichtigungen zugestellt werden.In battery saver mode, only the most important notifications should be delivered. Während das Gerät angeschlossen ist, können Synchronisierungs-oder nicht zeitkritische Vorgänge abgeschlossen werden.While the device is plugged in, sync or non-time critical operations can be completed.

Windows weiß nicht, welche Benachrichtigungen für einen Benutzer oder eine APP wichtig sind, sodass das System vollständig von apps abhängig ist, um die richtige Priorität für Ihre Benachrichtigungen festzulegen.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.

PrioritätenPriorities

Es stehen vier Prioritäten für eine App zur Verfügung, die beim Senden von Pushbenachrichtigungen verwendet werden können.There are four priorities available for an app to use when sending push notifications. Die Priorität wird für einzelne Benachrichtigungen festgelegt, sodass Sie auswählen können, welche Benachrichtigungen umgehend zugestellt werden müssen (z. b. eine im-Nachricht) und welche Wartezeiten Sie warten können (z. b. mit Foto Aktualisierungen).The priority is set on individual notifications, allowing you to choose which notifications need to be delivered instantly (for example, an IM message) and which ones can wait (for example, contact photo updates).

Die Prioritäten lauten:The priorities are:

PrioritätPriority Benutzer AußerkraftsetzungUser Override BESCHREIBUNGDescription BeispielExample
HighHigh Ja – der Benutzer kann alle Benachrichtigungen von einer APP blockieren oder verhindern, dass eine APP im Akku Spar Modus gedrosselt wird.Yes – user can block all notifications from an app OR can prevent an app from being throttled in battery saver mode. Die wichtigsten Benachrichtigungen, die sofort übermittelt werden müssen, wenn das Gerät Benachrichtigungen empfangen kann.The most important notifications that must be delivered right away in any circumstance when the device can receive notifications. Dinge wie VoIP-Anrufe oder kritische Warnungen, die das Gerät reaktivieren sollten, fallen in diese Kategorie.Things like VoIP calls or critical alerts that should wake the device fall into this category. VoIP-Anrufe, zeitkritische WarnungenVoIP calls, time- critical alerts
MediumMedium Ja – der Benutzer kann alle Benachrichtigungen von einer APP blockieren oder verhindern, dass eine APP im Akku Spar Modus gedrosselt wird.Yes – user can block all notifications from an app OR can prevent an app from being throttled in battery saver mode. Dabei handelt es sich um Dinge, die nicht so wichtig sind, aber Dinge, die nicht sofort ausgeführt werden müssen. die Benutzer sind jedoch verärgert, wenn Sie nicht im Hintergrund ausgeführt werden.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. Sekundäre e-Mail-Konto Synchronisierung, Live-Kachel AktualisierungenSecondary Email account sync, live tile updates.
NiedrigLow Ja – der Benutzer kann alle Benachrichtigungen von einer APP blockieren oder verhindern, dass eine APP im Akku Spar Modus gedrosselt wird.Yes – user can block all notifications from an app OR can prevent an app from being throttled in battery saver mode. Benachrichtigungen, die nur sinnvoll sind, wenn der Benutzer das Gerät verwendet oder wenn Hintergrund Aktivität sinnvoll ist.Notifications that only make sense when the user is using the device or when background activity makes sense. Diese werden zwischengespeichert und erst verarbeitet, wenn sich der Benutzer anmeldet oder in seinem Gerät einfügt.These are cached and not processed until the user signs in or plugs in their device. Kontakt Status (Online/Offline)Contact status (online/offline)
Sehr niedrigVery Low Nein – es kann nicht verhindern, dass Benachrichtigungen mit sehr niedriger Priorität im Akku Spar Modus gedrosselt werden.No – It cannot prevent very low priority notifications from being throttled in battery saver mode. Dies ist fast identisch mit niedriger Priorität, außer dass Benutzer die Akku-sparrichtlinie nicht außer Kraft setzen können.This is almost the same as low priority except users cannot override the battery saver policy. Diese Benachrichtigungen werden nie in Akku Schoner zugestellt.These notifications will never be delivered in battery saver. Synchronisieren von Dateien für einen Synchronisierungs Dienst.Syncing files for a sync service.

Beachten Sie, dass viele apps über den gesamten Lebenszyklus hinweg Benachrichtigungen mit unterschiedlichen Prioritäten erhalten.Note that many apps will have notifications of different priority throughout their lifecycle. Da die Priorität pro Benachrichtigung festgelegt wird, ist dies kein Problem.Since the priority is set on a per-notification basis, this isn’t an issue. Eine VoIP-App kann eine Benachrichtigung mit hoher Priorität für einen eingehenden Rückruf senden und Sie dann mit einer niedrigen Priorität nachverfolgen, wenn ein Kontakt online geschaltet wird.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.

Festlegen der PrioritätSetting the priority

Das Festlegen der Priorität für die Benachrichtigungs Anforderung erfolgt über einen zusätzlichen Header in der Post-Anforderung X-WNS-PRIORITY .Setting the priority on the notification request is done through an additional header on the POST request, X-WNS-PRIORITY. Dies ist ein ganzzahliger Wert zwischen 1 und 4, der einer Priorität zugeordnet ist:This is an integer value between 1 and 4 which maps to a priority:

Prioritäts NamePriority Name X-WNS-Priority-WertX-WNS-PRIORITY Value Standardwert für:Default for:
HighHigh 11 PopupsToasts
MittlererMeduim 22 Kacheln und AbzeichenTiles and Badges
NiedrigLow 33 RawRaw
Sehr niedrigVery Low 44

Das Festlegen einer Priorität ist nicht erforderlich, um abwärts kompatibel zu sein.To be backward compatible, setting a priority is not required. Für den Fall, dass eine APP die Priorität Ihrer Benachrichtigungen nicht festgelegt, wird vom System eine Standardpriorität bereitgestellt.In case an app doesn’t set the priority of their notifications, the system will provide a default priority. Die Standardwerte werden im obigen Diagramm angezeigt und entsprechen dem Verhalten vorhandener Versionen von Windows.The defaults are shown in the chart above and match the behavior of existing versions of Windows.

Ausführliche Auflistung von Desktop VerhaltenDetailed listing of desktop behavior

Wenn Sie Ihre APP über viele verschiedene SKUs von Windows versenden, empfiehlt es sich in der Regel, das Diagramm im obigen Abschnitt zu befolgen.If you are shipping your app across many different SKUs of Windows, it is normally best to follow the chart in the above section.

Spezifischere Empfohlene Verhaltensweisen für jede Priorität sind unten aufgeführt.More specific recommended behaviors for each priority are listed below. Dies ist keine Garantie dafür, dass jedes Gerät genau entsprechend dem Diagramm funktioniert.This is not a guarantee that each device will work exactly according to the chart. OEMs können das Verhalten anders konfigurieren, aber die meisten sind in der Nähe dieses Diagramms.OEMs are free to configure the behavior differently, but most are close to this chart.

Device StateDevice State Priorität: hochPRIORITY: High Priorität: MittelPRIORITY: Medium Priorität: niedrigPRIORITY: Low Priorität: sehr niedrigPRIORITY: Very Low
Bildschirm ein-oder angeschlossenScreen On OR plugged in BereitstellenDeliver BereitstellenDeliver BereitstellenDeliver BereitstellenDeliver
Bildschirm aus und AkkuScreen Off AND on battery BereitstellenDeliver Wenn Benutzer ausgenommen: Übermitteln von else: BatchIf user exempted: deliver Else: batch Wenn Benutzer ausgenommen: Übermitteln von else: Cache *If user exempted: deliver Else: cache * CacheCache
Akku Schoner aktiviertBattery Saver enabled Wenn Benutzer ausgenommen: Übermitteln von else: CacheIf user exempted: deliver Else: cache Wenn Benutzer ausgenommen: Übermitteln von else: CacheIf user exempted: deliver Else: cache Wenn Benutzer ausgenommen: Übermitteln von else: CacheIf user exempted: deliver Else: cache CacheCache
Auf Akku + Akku Schoner aktiviert + Bildschirm ausOn battery + battery saver enabled + screen off Wenn Benutzer ausgenommen: Übermitteln von else: CacheIf user exempted: deliver Else: cache Wenn Benutzer ausgenommen: Übermitteln von else: CacheIf user exempted: deliver Else: cache Wenn Benutzer ausgenommen: Übermitteln von else: CacheIf user exempted: deliver Else: cache CacheCache

Beachten Sie, dass Benachrichtigungen mit niedriger Priorität standardmäßig für den Abbild Modus und Batterie nur für Windows Phone basierte Geräte übermittelt werden.Note that low priority notifications will be delivered by default for screen off and battery only for Windows Phone based devices. Dies ist die Kompatibilität mit einer bereits vorhandenen mpns-Richtlinie.This is to maintian compatibility with preexisting MPNS policy. Beachten Sie auch, dass die vierte und fünfte Zeile identisch sind, indem Sie lediglich verschiedene Szenarien aufrufen.Also note that the fourth and fifth rows are the same, just calling out different scenarios.

Um eine APP im Akku Spar Modus auszumachen, müssen die Benutzer in den Einstellungen zur "Akku Nutzung nach app" wechseln und "zulassen, dass die APP Hintergrundaufgaben ausführen" auswählen.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." Bei Auswahl dieser Option wird die APP vom Akku Schoner für Benachrichtigungen mit hoher, mittlerer und niedriger Priorität ausgenommen.This user selection exempts the app from battery saver for high, medium, and low priority notifications. Sie können auch die backgroundexecutionmanager-API anrufen, um die Berechtigung des Benutzers Programm gesteuert anzufordern.You can also call BackgroundExecutionManager API to programatically ask for the user's permission.