Пользовательские метки времени в уведомлениях приложения

  • Статья

По умолчанию метка времени уведомлений приложений, видимая в Центре уведомлений, устанавливается на время отправки уведомления. При необходимости можно переопределить метку времени с помощью собственной пользовательской даты и времени, чтобы метка времени представляла время создания сообщения или информации или содержимого, а не времени отправки уведомления. Это также гарантирует, что уведомления отображаются в правильном порядке в Центре уведомлений, который отсортирован по времени. Рекомендуется, чтобы большинство приложений указали настраиваемую метку времени.

Эта функция доступна в Windows Build 15063 и более поздних версиях.

App notification with custom timestamp

Примечание.

Термин "всплывающее уведомление" заменяется на "уведомление приложения". Эти термины относятся к одной и той же функции Windows, но с течением времени мы будем поэтапно использовать всплывающее уведомление в документации.

Чтобы использовать настраиваемую метку времени, просто назначьте свойство displayTimestamp в элементе всплывающего элемента полезных данных XML-уведомлений приложения. Начиная с пакета SDK для приложений Windows 1.2, можно добавить настраиваемую метку времени в уведомление приложения с помощью Microsoft.Windows.AppNotifications.Builder. Для приложений UWP можно использовать библиотеку NuGet для набор средств сообщества UWP версии 1.4.0 или более поздней. YOu an также укажите метку времени с помощью необработанного XML.

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));

При использовании XML дата должна быть отформатирована в ФОРМАТЕ ISO 8601.

Примечание.

Вы можете использовать только не более 3 десятичных разрядов в секундах (хотя реально нет никакого значения в предоставлении чего-либо детализированного). Если вы предоставляете больше, полезные данные будут недопустимыми, и вы получите уведомление "Новое уведомление".

Руководство по использованию

Как правило, рекомендуется указывать настраиваемую метку времени в большинстве приложений. Это гарантирует точное представление метки времени уведомления при создании сообщения или информации или содержимого независимо от задержек сети, режима самолета или фиксированного интервала периодических фоновых задач.

Например, приложение новостей может выполнять фоновую задачу каждые 15 минут, которая проверка для новых статей и отображает уведомления. Перед пользовательскими метками времени метка времени соответствовала моменту создания уведомления приложения (поэтому всегда в 15 минут). Однако теперь приложение может задать метку времени до момента публикации статьи. Аналогичным образом, почтовые приложения и приложения социальных сетей могут воспользоваться этой функцией, если для их уведомлений используется аналогичный шаблон периодического извлечения.

Кроме того, предоставление пользовательской метки времени гарантирует правильность метки времени, даже если пользователь был отключен от Интернета. Например, когда пользователь включает свой компьютер и выполняет фоновую задачу, вы можете, наконец, убедиться, что метка времени на уведомлениях представляет время отправки сообщений, а не время, когда пользователь включил свой компьютер.

Метка времени по умолчанию

Если вы не предоставляете настраиваемую метку времени, мы используем время отправки уведомления.

Если вы отправили push-уведомление через WNS, мы используем время получения уведомления сервером WNS (поэтому любая задержка при доставке уведомления на устройство не повлияет на метку времени).

Если вы отправили локальное уведомление, мы используем время, когда платформа уведомлений получила уведомление (которое должно быть немедленно).