Реализуем пуш-уведомления на фронтенде и бэкенде

В предыдущей статье об iss-observer.com я обещал рассказать о технической стороне реализации пуш-уведомлений. Изначально я планировал сконцентрироваться на проблемах, с которыми пришлось иметь дело в процессе работы над iss-observer.com. Теперь я думаю, будет полезнее посвятить материал базовым вопросам, и уточнять детали, где это необходимо. Обращаю ваше внимание, что фронтенд частично опирается на этот урок.

Если вы хотите углубиться в исходный код, то смотрите в GitHub-репозиторий и на пример , демонстрирующий его работу.

Фронтенд

Начнем с клиентской части. Первое, что нужно сделать — убедиться, что браузер поддерживает пуш-уведомления. Если да, загружаем наш JavaScript.

Прежде чем писать код, выполним ряд требований. Нам потребуются Application Server Keys (VAPID Key). Получаем их здесь, либо с помощью библиотеки web-push. Кстати, она нам еще потребуется для бэкенд-части. Устанавливаем библиотеку: npm install -g web-push , генерируем ключи: web-push generate-vapid-keys . В независимости от способа в результате у вас должны быть закрытый ключ (private key) и открытый ключ (public key). Сохраните их в надежном месте.

До появления спецификации Application server key/VAPID первые браузеры (Chrome, Opera) реализовали функциональность пуш-уведомлений с помощью Google Cloud Messaging . Все современные браузеры, за исключением Samsung Internet , поддерживают VAPID. Поэтому в этой статье я не буду касаться GCM. Как добавить поддержку для Samsung Internet и старых версий Chrome и Opera — читайте здесь .

Посмотрим на push.js. Здесь мы регистрируем сервис-воркер и подписываемся на уведомления:

В первую очередь создаем константу addServiceKey : ей присваиваем значение с открытым ключ VAPID (о нем мы говорили выше). Также создаем несколько элементов и переменных. Записываем функцию urlB64ToUint8Array() : она понадобится для конвертации ключа из base64 в Uint8Array.

Затем декларируем функцию updatePushButton() . Мы будем вызывать её каждый раз при изменении статуса уведомлений, чтобы обновить отвечающие за него элементы интерфейса.

Далее видим функцию регистрации подписки subscribeUser() . Как вы наверно заметили, в начале скрипта была объявлена переменная let serviceWorkerRegistration . Она содержит результат регистрации сервис-воркера: посмотрите в конец файла, мы записываем его в переменную в момент регистрации.

Метод subscribe() возвращает промис, а в качестве аргумента принимает объект с двумя свойствами:

• userVisibilityOnly : булево значение. Параметр сообщает, что подписка будет использоваться только для сообщений, эффект которых виден для пользователя. Устанавливаем значение true .
• applicationServiceKey : номер открытого ключа, он используется сервером для отправки уведомлений. Так как ключ должен быть в формате UInt8Attay, используем уже знакомую нам функцию.

Теперь отправляем данные подписки на сервер. Смело используем Fetch API, так как все браузеры, которые поддерживают пуш-уведомления, поддерживают и Fetch. После получения ответа выводим результат — завершена ли подписка успешно.

Этот этап прекрасно подходит для уточнения нужных параметров у пользователя. Например, на iss-observer.com он может выбрать время получения уведомлений (утро и/или вечер). Я также отправляю на сервер данные о стране, регионе и городе, по которому пользователь хочет получать уведомления; данные сохраняются и могут потребоваться при отправке уведомлений.

После этого, создаем функцию отписки unsubscribeUser() . Используем метод getSubscription() объекта PushManager , с его помощью получаем детали подписки, которые отправляем на сервер (снова Fetch API). На этот раз, чтобы удалить её базы.

Записываем функцию initPush() . В ней — событие для кнопки pushButton, которое вызывает функцию подписки или отписки в зависимости от текущего состояния. После, не забываем обновить это состояние. Использованный в примере код можно найти на GitHub.

Последний шаг — регистрация сервис-воркера.

Сервис-воркер

В этой части мы разберем два необходимых для реализации пуш-уведомлений события: push и notificationonclick .

Начнем с push . Проверяем содержимое объекта notificationData (свойства title , body и icon ), и, если не находим их, присваиваем дефолтные значения. После вызываем метод showNotification , он покажет уведомление пользователю.

В дополнение к трём перечисленным свойствам могут использоваться и другие, например, badge , tag , vibrate . На момент написания этой статьи (февраль 2017) многие из них поддерживались только некоторыми браузерами. title , body и icon , доступных во всех браузерах, поэтому ограничимся ими.

Событие notificationOnClick срабатывает в момент клика по уведомлению. Сначала закрываем уведомление. Затем проверяем, открыт ли наш сайт в текущей вкладке браузера, если нет, то открываем его с помощью openWindow() .

Бэкенд

Переходим к серверной части, в которой мы используем web-push library. В нашем случае это реализация библиотеки для Node.js, но версии для PHP, Java и C# также доступны.

Я предполагаю, что у вас есть базовые знания Node.js и опыт использования Express. В ином случае, я рекомендую вам ознакомиться с ними прежде чем продолжить.

Итак, в первую очередь:

• устанавливаем библиотеку командой npm install web-push —save ,
• получаем доступ к ней с помощью require : const webPush = require(‘web-push’);

Теперь передаем данные VAPID. Помимо сгенерированной в начале пары ключей, нужно указать адрес электронной почты (с префиксом mailto: ) либо URL сайта. Контактные данные могут потребоваться сервису для связи с вами. Обратите внимание на комментарии: я предпочел сохранить ключи в переменную окружения. Вы можете поступить так же или выбрать свой метод, но главное помните, закрытый ключ должен быть всегда защищен от обращений извне. Собственно поэтому он так и назван.

Переходим к функции подписки:

В функции отправки подписки на сервер, получаем доступ к объекту subscription . В нем — значение endpoint и ключи доступа. Здесь я не буду останавливаться на вопросах работы с базой данных. Для примера укажу только, что для демо использована Mongo DB.

Прим. переводчика: endpoint — это уникальный URI, создаваемый для каждого пользователя индивидуально в соответствии с паттерном : p256dh — открытый ключ, auth — закрытый ключ.

Затем получаем наше первое уведомление — то, которое приветствует подписавшегося пользователя. Метод sendNotification() принимает три аргумента:

• данные подписки, получаемые от браузера;
• информацию для пользователя (заголовок, сообщение, иконка — свойства title , body , icon соответственно);
• объект options , см. подробнее.

TTL (Time To Live) — срок жизни уведомления —по умолчанию четыре недели. Это значит, что оно будет ожидать появления пользователя онлайн в течение этого срока. Например, если вы отправили уведомление пользователю в оффлайне, и он подключится к сети только через две недели, сообщение все равно будет доставлено. В моем случае разумно изменить TTL на более короткий срок.

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

Дополнительно

Вероятно, каждый из вас столкнется со своим случаем применения пуш-уведомлений, и просто скопировать код не получится. Однако я надеюсь, что этот урок поможет вам реализовать искомую функциональность как на стороне клиента, так и на стороне сервера.

Демо проекта, исходный код опубликован на GitHub.

Для более глубокого погружения в тему рекомендую бесплатную книгу Web Push Book и примеры на servicewore.rs.

Если вам есть что спросить, или есть что добавить, пишите в Twitter или по электронной почте.

Обзор служб push-уведомлений Windows (WNS) Windows Push Notification Services (WNS) overview

Push-Notification Services Windows (WNS) позволяют сторонним разработчикам отправлять всплывающие уведомления, плитки, эмблемы и необработанные обновления из собственной облачной службы. The Windows Push Notification Services (WNS) enable third-party developers to send toast, tile, badge, and raw updates from their own cloud service. Это обеспечивает энергоэффективный и надежный механизм передачи пользователям свежих обновлений. This provides a mechanism to deliver new updates to your users in a power-efficient and dependable way.

Принцип работы How it works

На следующей схеме показан весь поток данных, связанный с отправкой push-уведомлений. The following diagram shows the complete data flow for sending a push notification. Он предусматривает следующие этапы. It involves these steps:

1. Приложение запрашивает канал push-уведомлений от WNS. Your app requests a push notification channel from WNS.
2. Windows отправляет запрос в WNS на создание канала уведомлений. Windows asks WNS to create a notification channel. Этот канал возвращается отправившему вызов устройству в виде универсального кода ресурса (URI). This channel is returned to the calling device in the form of a Uniform Resource Identifier (URI).
3. В приложении WNS возвращается универсальный код ресурса (URI) канала уведомления. The notification channel URI is returned by WNS to your app.
4. Ваше приложение отправляет URI в вашу облачную службу. Your app sends the URI to your own cloud service. Затем URI помещается на хранение в вашу собственную облачную службу, чтобы вы могли осуществлять к нему доступ при отправке уведомлений. You then store the URI on your own cloud service so that you can access the URI when you send notifications. URI выступает в роли интерфейса между вашим приложением и вашей службой. Вы несете ответственность за реализацию этого интерфейса в соответствии с веб-стандартами надежности и безопасности. The URI is an interface between your own app and your own service; it’s your responsibility to implement this interface with safe and secure web standards.
5. Когда в вашей облачной службе появляется обновление, которое необходимо отправить, служба уведомляет WNS с помощью URI канала. When your cloud service has an update to send, it notifies WNS using the channel URI. Это осуществляется с помощью выпуска через SSL запроса HTTP POST, включающего полезные данные уведомления. This is done by issuing an HTTP POST request, including the notification payload, over Secure Sockets Layer (SSL). На этом этапе требуется проверка подлинности. This step requires authentication.
6. WNS получает запрос и направляет уведомление на соответствующее устройство. WNS receives the request and routes the notification to the appropriate device.

Регистрация вашего приложения и получение учетных данных для вашей облачной службы Registering your app and receiving the credentials for your cloud service

Прежде чем отправлять уведомления с помощью WNS, приложение должно быть зарегистрировано на панели мониторинга магазина, как описано здесь. Before you can send notifications using WNS, your app must be registered with the Store Dashboard, as described here.

Запрос на получение канала уведомлений Requesting a notification channel

Приложение, которое может получать извещающие уведомления, должно после запуска отправить с помощью метода CreatePushNotificationChannelForApplicationAsync запрос на получение канала уведомлений. When an app that is capable of receiving push notifications runs, it must first request a notification channel through the CreatePushNotificationChannelForApplicationAsync. Дополнительные сведения и пример кода см. в разделе Запрос, создание и сохранение канала уведомлений. For a full discussion and example code, see How to request, create, and save a notification channel. Этот API возвращает URI канала, однозначно связанный с вызывающим приложением и его плиткой, через который могут пересылаться типы уведомлений. This API returns a channel URI that is uniquely linked to the calling application and its tile, and through which all notification types can be sent.

После успешного создания URI канала приложение отправляет его в свою облачную службу вместе со всеми метаданными приложения, которые должны быть сопоставлены с этим URI. After the app has successfully created a channel URI, it sends it to its cloud service, together with any app-specific metadata that should be associated with this URI.

Важные примечания Important notes

• Нельзя гарантировать, что URI канала уведомлений для приложения будет всегда оставаться неизменным. We do not guarantee that the notification channel URI for an app will always remain the same. Мы рекомендуем, чтобы приложение запрашивало новый канал при каждом запуске и обновляло свою службу при изменении URI. We advise that the app requests a new channel every time it runs and updates its service when the URI changes. Разработчик никогда не должен изменять URI канала и должен рассматривать его как строку с неизвестным содержимым. The developer should never modify the channel URI and should consider it as a black-box string. В настоящее время срок действия URI каналов истекает через 30 дней. At this time, channel URIs expire after 30 days. Если ваше приложение для Windows 10 будет периодически обновлять свой канал в фоновом режиме, вы сможете скачать пример push-уведомлений и периодических уведомлений для Windows 8.1 и затем использовать его исходный код и шаблон, которые демонстрируются. If your Windows 10 app will periodically renew its channel in the background then you can download the Push and periodic notifications sample for Windows 8.1 and re-use its source code and/or the pattern it demonstrates.
• Интерфейс между облачной службой и клиентским приложением реализует разработчик. The interface between the cloud service and the client app is implemented by you, the developer. Рекомендуется, чтобы приложение проходило процесс проверки подлинности с помощью собственной службы и передавало данные по безопасному протоколу, например по HTTPS. We recommend that the app go through an authentication process with its own service and transmit data over a secure protocol such as HTTPS.
• Необходимо, чтобы облачная служба всегда проверяла, что URI канала использует домен «notify.windows.com». It is important that the cloud service always ensures that the channel URI uses the domain «notify.windows.com». Служба никогда не должна отправлять уведомления каналу, использующему любой другой домен. The service should never push notifications to a channel on any other domain. Если обратный вызов для вашего приложения будет скомпрометирован, злоумышленник может отправить URI канала, чтобы подделать WNS. If the callback for your app is ever compromised, a malicious attacker could submit a channel URI to spoof WNS. Без проверки домена ваша облачная служба может неясно раскрывать информацию для этого злоумышленника. Without inspecting the domain, your cloud service could potentially disclose information to this attacker unknowingly.
• Если ваша облачная служба делает попытки доставить уведомление каналу, у которого истек срок действия URI, WNS возвратит код ответа 410. If your cloud service attempts to deliver a notification to an expired channel, WNS will return response code 410. В ответ на этот код служба должна прекратить попытки отправлять уведомления этому URI. In response to that code, your service should no longer attempt to send notifications to that URI.

Проверка подлинности облачной службы Authenticating your cloud service

Чтобы уведомление было отправлено, облачная служба должна пройти проверку подлинности с помощью WNS. To send a notification, the cloud service must be authenticated through WNS. Первый шаг процесса состоит в регистрации вашего приложения в информационной панели Microsoft Store. The first step in this process occurs when you register your app with the Microsoft Store Dashboard. Во время регистрации ваше приложение получает идентификатор безопасности пакета и секретный ключ. During the registration process, your app is given a Package security identifier (SID) and a secret key. Эти сведения используются облачной службой для проверки подлинности с помощью WNS. This information is used by your cloud service to authenticate with WNS.

Схема проверки подлинности с помощью WNS реализуется с использованием профиля учетных данных клиента из протокола OAuth 2.0. The WNS authentication scheme is implemented using the client credentials profile from the OAuth 2.0 protocol. Облачная служба проходит проверку подлинности с помощью WNS, предоставляя свои учетные данные (идентификатор безопасности пакета и секретный ключ). The cloud service authenticates with WNS by providing its credentials (Package SID and secret key). Взамен она получает маркер доступа. In return, it receives an access token. Этот маркер доступа позволяет облачной службе отправить уведомление. This access token allows a cloud service to send a notification. Маркер необходим для каждого запроса на уведомление, отправляемого в WNS. The token is required with every notification request sent to the WNS.

На высоком уровне существует следующая информационная цепочка. At a high level, the information chain is as follows:

1. Облачная служба отправляет свои учетные данные в WNS по HTTPS согласно протоколу OAuth 2.0. The cloud service sends its credentials to WNS over HTTPS following the OAuth 2.0 protocol. Таким образом служба проходит проверку подлинности с помощью WNS. This authenticates the service with WNS.
2. Если проверка подлинности пройдена успешно, WNS возвращает маркер доступа. WNS returns an access token if the authentication was successful. Этот маркер доступа используется во всех последующих запросах на уведомления вплоть до истечения срока его действия. This access token is used in all subsequent notification requests until it expires.

При проверке подлинности с помощью WNS облачная служба отправляет HTTP-запрос по протоколу SSL. In the authentication with WNS, the cloud service submits an HTTP request over Secure Sockets Layer (SSL). Параметры предоставляются в формате «application/x-www-for-urlencoded». The parameters are supplied in the «application/x-www-for-urlencoded» format. Укажите идентификатор безопасности пакета в _ поле «идентификатор клиента» и секретный ключ в поле «Секрет клиента» _ , как показано в следующем примере. Supply your Package SID in the «client_id» field and your secret key in the «client_secret» field as shown in the following example. Дополнительные сведения о синтаксисе см. в справочнике по запросу маркера доступа. For syntax details, see the access token request reference.

Это лишь пример, но не Вырезание и вставка кода, который можно успешно использовать в собственном коде. This is just an example, not cut-and-paste code that you can successfully use in your own code.

WNS проверяет подлинность облачной службы и, в случае успеха, отправляет ответ «200 OK». The WNS authenticates the cloud service and, if successful, sends a response of «200 OK». Маркер доступа возвращается в параметрах, включенных в текст ответа HTTP, с использованием типа содержимого «application/json». The access token is returned in the parameters included in the body of the HTTP response, using the «application/json» media type. После того как ваша служба получит маркер доступа, вы сможете отправлять уведомления. After your service has received the access token, you are ready to send notifications.

В следующем примере показан ответ успешной проверки подлинности, содержащий, в том числе, маркер доступа. The following example shows a successful authentication response, including the access token. Дополнительные сведения о синтаксисе см. в разделе Заголовки запроса и ответа службы push-уведомлений. For syntax details, see Push notification service request and response headers.

Важные примечания Important notes

• Протокол OAuth 2.0, поддерживаемый в этой процедуре, следует версии проекта V16. The OAuth 2.0 protocol supported in this procedure follows draft version V16.
• В документе RFC о протоколе OAuth под термином «клиент» подразумевается облачная служба. The OAuth Request for Comments (RFC) uses the term «client» to refer to the cloud service.
• В окончательном проекте протокола OAuth возможны изменения этой процедуры. There might be changes to this procedure when the OAuth draft is finalized.
• Маркер доступа можно повторно использовать для нескольких запросов на уведомления. The access token can be reused for multiple notification requests. Это позволяет облачной службе только один раз проходить проверку подлинности, чтобы отправлять множество уведомлений. This allows the cloud service to authenticate just once to send many notifications. Но, после того как срок действия маркера доступа истекает, облачная служба должна снова пройти проверку подлинности, чтобы получить новый маркер доступа. However, when the access token expires, the cloud service must authenticate again to receive a new access token.

Отправка уведомления Sending a notification

Используя URI канала, облачная служба может отправлять уведомление всякий раз, когда у нее есть обновление для пользователя. Using the channel URI, the cloud service can send a notification whenever it has an update for the user.

Маркер доступа, описанный выше, может повторно использоваться для нескольких запросов на уведомления; облачной службе не нужно запрашивать новый маркер доступа для каждого уведомления. The access token described above can be reused for multiple notification requests; the cloud server is not required to request a new access token for every notification. Если срок действия маркера доступа истек, при запросе уведомления будет возвращена ошибка. If the access token has expired, the notification request will return an error. Мы рекомендуем не пытаться повторять отправку уведомления более одного раза, если маркер доступа был отклонен. We recommended that you do not try to re-send your notification more than once if the access token is rejected. При возникновении такой ошибки вам потребуется запросить новый маркер доступа и повторно отправить уведомление. If you encounter this error, you will need to request a new access token and resend the notification. Точный код ошибки см. в разделе Коды ответов push-уведомлений. For the exact error code, see Push notification response codes.

Облачная служба выполняет запрос HTTP POST к URI канала. The cloud service makes an HTTP POST to the channel URI. Запрос должен быть выполнен по протоколу SSL и содержать необходимые полезные данные уведомления и заголовки. This request must be made over SSL and contains the necessary headers and the notification payload. Заголовок авторизации должен содержать маркер доступа для авторизации. The authorization header must include the acquired access token for authorization.

Пример запроса показан ниже. An example request is shown here. Дополнительные сведения о синтаксисе см. в разделе Коды ответов push-уведомлений. For syntax details, see Push notification response codes.

Подробнее о составлении полезных данных уведомления см. в разделе Краткое руководство: отправка push-уведомлений. For details on composing the notification payload, see Quickstart: Sending a push notification. Полезные данные плитки, всплывающего уведомления или push-уведомления индикатора событий поставляются в виде XML-содержимого, созданного в соответствии с определенными для него схемой адаптивных плиток или схемой устаревших плиток. The payload of a tile, toast, or badge push notification is supplied as XML content that adheres to their respective defined Adaptive tiles schema or Legacy tiles schema. Полезные данные необработанных уведомлений не имеют определенной структуры. The payload of a raw notification does not have a specified structure. Они определяются исключительно приложением. It is strictly app-defined.

WNS отвечает, чтобы показать, что уведомление получено и будет доставлено при следующей возможности. WNS responds to indicate that the notification has been received and will be delivered at the next available opportunity. Однако WNS не предоставляет сквозного подтверждения того, что ваше уведомление было получено устройством или приложением. However, WNS does not provide end-to-end confirmation that your notification has been received by the device or application.

На этой схеме показан поток данных: This diagram illustrates the data flow:

Важные примечания Important notes

• WNS не гарантирует надежности или задержки уведомления. WNS does not guarantee the reliability or latency of a notification.
• Уведомления никогда не должны содержать конфиденциальных данных. Notifications should never include confidential or sensitive data.
• Чтобы уведомление было отправлено, облачная служба должна сначала пройти проверку подлинности с помощью WNS и получить маркер доступа. To send a notification, the cloud service must first authenticate with WNS and receive an access token.
• Маркер доступа позволяет облачной службе отправлять уведомления только в то приложение, для которого он был создан. An access token only allows a cloud service to send notifications to the single app for which the token was created. Один маркер доступа нельзя использовать для отправки уведомлений нескольким приложениям. One access token cannot be used to send notifications across multiple apps. Следовательно, если ваша облачная служба поддерживает несколько приложений, она должна предоставлять правильный маркер доступа для приложения при отправке уведомления в каждый URI канала. Therefore, if your cloud service supports multiple apps, it must provide the correct access token for the app when pushing a notification to each channel URI.
• Если устройство не в сети, по умолчанию WNS хранит до пяти уведомлений плитки (если включена организация очереди; в противном случае — одно уведомление плитки) и одно уведомление на индикаторе событий для каждого URI канала, при этом необработанные уведомления не сохраняются. When the device is offline, by default WNS will store up to five tile notifications (if queuing is enabled; otherwise, one tile notification) and one badge notification for each channel URI, and no raw notifications. Такая установленная по умолчанию схема кэширования может быть изменена посредством заголовка X-WNS-Cache-Policy. This default caching behavior can be changed through the X-WNS-Cache-Policy header. Примечание. Всплывающие уведомления никогда не сохраняются, если устройство не в сети. Note that toast notifications are never stored when the device is offline.
• В сценариях, где содержимое уведомления персонализировано для пользователя, WNS рекомендует облачной службе отправлять эти обновления сразу после их получения. In scenarios where the notification content is personalized to the user, WNS recommends that the cloud service immediately send those updates when those are received. К примерам такого сценария относятся обновления веб-каналов социальных сетей, приглашения к обмену мгновенными сообщениями, уведомления о новых сообщениях или оповещения. Examples of this scenario include social media feed updates, instant communication invitations, new message notifications, or alerts. Также возможны сценарии, в которых одно и то же общее обновление, например обновление прогноза погоды, котировок акций или новостей, часто доставляется большому подмножеству пользователей. As an alternative, you can have scenarios in which the same generic update is frequently delivered to a large subset of your users; for example, weather, stock, and news updates. В руководстве по WNS указано, что такие обновления не должны отправляться чаще одного раза каждые 30 минут. WNS guidelines specify that the frequency of these updates should be at most one every 30 minutes. Пользователь или WNS может решить, что более частая отправка стандартных обновлений является злоупотреблением. The end user or WNS may determine more frequent routine updates to be abusive.
• Платформа уведомлений Windows поддерживает периодическое подключение к данным с помощью WNS для поддержания активности сокета в активном состоянии и работоспособности. Windows Notification Platform maintains a periodic data connection with WNS to keep the socket alive and healthy. Если нет приложений, запрашивающих или использующих каналы уведомлений, сокет не будет создан. If there are no applications requesting or using notification channels then the socket will not be created.

Истечение сроков действий уведомлений на плитках и индикаторах событий Expiration of tile and badge notifications

По умолчанию срок действия уведомлений на индикаторах событий и плитках истекает через три дня с момента их загрузки. By default, tile and badge notifications expire three days after being downloaded. После истечения срока действия уведомления содержимое удаляется из плитки или очереди и больше не показывается пользователю. When a notification expires, the content is removed from the tile or queue and is no longer shown to the user. Рекомендуется установить срок действия для всех уведомлений на плитках и индикаторах событий (используя время, значимое для вашего приложения), чтобы гарантировать, что содержимое вашей плитки не будет сохраняться дольше, чем нужно. It’s a best practice to set an expiration (using a time that makes sense for your app) on all tile and badge notifications so that your tile’s content doesn’t persist longer than it is relevant. Явное указание срока действия важно для содержимого с определенной продолжительностью существования. An explicit expiration time is essential for content with a defined lifespan. Это также гарантирует удаление устаревшего содержимого, если облачная служба перестала отправлять уведомления или если пользователь отключился от сети на продолжительное время. This also assures the removal of stale content if your cloud service stops sending notifications, or if the user disconnects from the network for an extended period.

Ваша служба облачного хранилища может установить срок действия для каждого уведомления путем настройки заголовка X-WNS-TTL HTTP. Здесь указывается время (в секундах), в течение которого отправленное уведомление будет действовать. Your cloud service can set an expiration for each notification by setting the X-WNS-TTL HTTP header to specify the time (in seconds) that your notification will remain valid after it is sent. Дополнительные сведения см. в разделе запросы службы push-уведомлений и заголовки ответов. For more information, see Push notification service request and response headers.

Например, во время торгового дня на бирже срок действия для обновлений курсов акций можно установить равным двойному интервалу отправки (допустим, через час после получения при отправке уведомлений, выполняемом каждые полчаса). For example, during a stock market’s active trading day, you can set the expiration for a stock price update to twice that of your sending interval (such as one hour after receipt if you are sending notifications every half-hour). Рассмотрим другой пример: для новостного приложения можно определить, что один день является подходящим временем для истечения срока действия обновлений плитки ежедневных новостей. As another example, a news app might determine that one day is an appropriate expiration time for a daily news tile update.

Push-уведомления и экономия заряда Push notifications and battery saver

Режим экономии заряда позволяет продлить срок службы батареи путем ограничения активности фоновых процессов в устройстве. Battery saver extends battery life by limiting background activity on the device. В Windows 10 пользователь может задать автоматическое включение режима экономии заряда в случае падения уровня заряда ниже установленного порогового значения. Windows 10 lets the user set battery saver to turn on automatically when the battery drops below a specified threshold. При включенном режиме экономии заряда функция приема push-уведомлений будет выключена с целью экономии ресурсов батареи. When battery saver is on, the receipt of push notifications is disabled to save energy. Но есть пара исключений. But there are a couple exceptions to this. Указанные ниже параметры экономии заряда в Windows 10 (которые находятся в приложении Параметры) позволяют приложению получать push-уведомления даже когда режим экономии заряда включен. The following Windows 10 battery saver settings (found in the Settings app) allow your app to receive push notifications even when battery saver is on.

• Разрешить push-уведомления из любого приложения в режиме экономии заряда: этот параметр позволяет всем приложениям получать push-уведомления при включенном режиме экономии заряда. Allow push notifications from any app while in battery saver: This setting lets all apps receive push notifications while battery saver is on. Обратите внимание, что этот параметр применяется только в Windows 10 для настольных компьютеров (выпусков Домашняя, Профессиональная, Корпоративная и для образовательных учреждений). Note that this setting applies only to Windows 10 for desktop editions (Home, Pro, Enterprise, and Education).
• Всегда разрешено: этот параметр позволяет определенным приложениям работать в фоновом режиме (в том числе принимать push-уведомления) при включенной экономии заряда. Always allowed: This setting lets specific apps run in the background while battery saver is on — including receiving push notifications. Этот список обслуживается вручную пользователем. This list is maintained manually by the user.

Невозможно проверить состояние этих двух параметров, но вы можете проверить состояние функции экономии заряда. There is no way to check the state of these two settings, but you can check the state of battery saver. В Windows 10 для проверки состояния функции экономии заряда используйте свойство EnergySaverStatus. In Windows 10, use the EnergySaverStatus property to check battery saver state. Кроме того, ваше приложение может использовать событие EnergySaverStatusChanged для получения сведений об изменениях состояния функции экономии заряда. Your app can also use the EnergySaverStatusChanged event to listen for changes to battery saver.

Если работа приложения сильно зависит от push-уведомлений, мы рекомендуем уведомлять пользователей о том, что они могут не получать уведомления, если включен режим экономия заряда, и упростить им настройку параметров экономии заряда. If your app depends heavily on push notifications, we recommend notifying users that they may not receive notifications while battery saver is on and to make it easy for them to adjust battery saver settings. Используя схему универсального кода ресурса экономии заряда в Windows 10 ( ms-settings:batterysaver-settings ), вы можете предоставить удобную ссылку на приложение «Параметры». Using the battery saver settings URI scheme in Windows 10, ms-settings:batterysaver-settings , you can provide a convenient link to the Settings app.

При уведомлении пользователя о параметрах экономии заряда рекомендуется использовать способ подавления сообщения в будущем. When notifying the user about battery saver settings, we recommend providing a way to suppress the message in the future. Например, флажок dontAskMeAgainBox в примере ниже сохраняет выбор пользователя в свойстве LocalSettings. For example, the dontAskMeAgainBox checkbox in the following example persists the user’s preference in LocalSettings.

Ниже приведен пример того, как проверить, включена ли экономия заряда в Windows 10. Here’s an example of how to check whether battery saver is turned on in Windows 10. В этом примере приложение уведомляет пользователя, запускает приложение «Параметры» и открывает в нем раздел параметров экономии заряда. This example notifies the user and launches the Settings app to battery saver settings. dontAskAgainSetting позволяет пользователю больше не отображать это сообщение. The dontAskAgainSetting lets the user suppress the message if they don’t want to be notified again.

Этот код XAML для ContentDialog, который показан в данном примере. This is the XAML for the ContentDialog featured in this example.