Benutzerdefinierte Zeitstempel für App-Benachrichtigungen

  • Artikel

Standardmäßig wird der Zeitstempel für App-Benachrichtigungen, die in der Mitteilungszentrale sichtbar sind, auf die Zeit festgelegt, zu der die Benachrichtigung gesendet wurde. Optional können Sie den Zeitstempel mit Ihrem eigenen benutzerdefinierten Datum und ihrer Zeit überschreiben, sodass der Zeitstempel die Zeit darstellt, zu der die Nachricht/Informationen/Inhalte tatsächlich erstellt wurden und nicht die Zeit, zu der die Benachrichtigung gesendet wurde. Dadurch wird auch sichergestellt, dass Ihre Benachrichtigungen in der Mitteilungszentrale in der richtigen Reihenfolge angezeigt werden, die nach Zeit sortiert wird. Es wird empfohlen, dass die meisten Apps einen benutzerdefinierten Zeitstempel angeben.

Dieses Feature ist ab Windows Build 15063 und höher verfügbar.

App notification with custom timestamp

Hinweis

Der Begriff „Popupbenachrichtigung“ wird durch „App-Benachrichtigung“ ersetzt. Diese Begriffe beziehen sich beide auf das gleiche Feature von Windows, aber im Laufe der Zeit wird die Verwendung von „Popupbenachrichtigung“ in der Dokumentation auslaufen.

Um einen benutzerdefinierten Zeitstempel zu verwenden, weisen Sie einfach die displayTimestamp-Eigenschaft dem Popup-Element Ihres App-Benachrichtigungs-XML-Payloads zu. Ab Windows App SDK 1.2 können Sie einer App-Benachrichtigung mit dem Microsoft.Windows.AppNotifications.Builder einen benutzerdefinierten Zeitstempel hinzufügen. Für UWP-Apps können Sie Version 1.4.0 oder höher der UWP Community Toolkit Notifications NuGet-Bibliothek verwenden. Sie können den Zeitstempel auch mit unbearbeitetem XML angeben.

var builder = new AppNotificationBuilder()
    .AddText("Matt sent you a friend request")
    .AddText("Hey, wanna dress up as wizards and ride around on hoverboards?")
    .SetTimeStamp(new DateTime(2017, 04, 15, 19, 45, 00, DateTimeKind.Utc));

Wenn Sie XML verwenden, muss das Datum in ISO 8601 formatiert sein.

Hinweis

Sie können höchstens drei Dezimalstellen auf den Sekunden verwenden (obwohl realistischerweise eine so granulare Angabe nicht sinnvoll ist). Wenn Sie mehr angeben, ist der Payload ungültig und Sie erhalten die Benachrichtigung „Neue Benachrichtigung“.

Verwendungsleitfaden

Im Allgemeinen wird empfohlen, dass die meisten Apps einen benutzerdefinierten Zeitstempel angeben. Dadurch wird sichergestellt, dass der Zeitstempel der Benachrichtigung genau darstellt, wann die Nachricht/Informationen/Inhalte generiert wurden, unabhängig von Netzwerkverzögerungen, Flugzeugmodus oder dem festen Intervall regelmäßiger Hintergrundaufgaben.

Eine Nachrichten-App kann beispielsweise alle 15 Minuten eine Hintergrundaufgabe ausführen, die nach neuen Artikeln sucht und Benachrichtigungen anzeigt. Vor benutzerdefinierten Zeitstempeln entspricht der Zeitstempel dem Zeitpunkt, an dem die App-Benachrichtigung generiert wurde (daher immer in 15-Minuten-Intervallen). Jetzt kann die App den Zeitstempel jedoch auf die Zeit festlegen, zu dem der Artikel tatsächlich veröffentlicht wurde. Ebenso können E-Mail-Apps und Apps für soziale Netzwerke von diesem Feature profitieren, wenn für ihre Benachrichtigungen ein ähnliches Muster für regelmäßiges Pulling verwendet wird.

Darüber hinaus stellt die Bereitstellung eines benutzerdefinierten Zeitstempels sicher, dass der Zeitstempel korrekt ist, auch wenn der Benutzer vom Internet getrennt wurde. Wenn der Benutzer beispielsweise seinen Computer einschaltet und die Hintergrundaufgabe ausgeführt wird, können Sie schließlich sicherstellen, dass der Zeitstempel auf Ihren Benachrichtigungen die Zeit darstellt, zu der die Nachrichten gesendet wurden, anstatt zu der Zeit, zu der der Benutzer seinen Computer aktiviert hat.

Standardzeitstempel

Wenn Sie keinen benutzerdefinierten Zeitstempel angeben, verwenden wir die Zeit, zu der Ihre Benachrichtigung gesendet wurde.

Wenn Sie eine Pushbenachrichtigung über WNS gesendet haben, verwenden wir die Zeit, zu der die Benachrichtigung vom WNS-Server empfangen wurde (sodass sich jede Wartezeit beim Übermitteln der Benachrichtigung an das Gerät nicht auf den Zeitstempel auswirkt).

Wenn Sie eine lokale Benachrichtigung gesendet haben, verwenden wir die Zeit, zu der die Benachrichtigungsplattform die Benachrichtigung erhalten hat (was sofort sein sollte).