Краткое руководство: настройка периодических уведомлений (HTML)

Статья
12/12/2015

[ Эта статья адресована разработчикам приложений среды выполнения Windows для Windows 8.x и Windows Phone 8.x. При разработке приложений для Windows 10 см. раздел последняя документация]

Примечание Не используете JavaScript? Подробнее: Краткое руководство: настройка периодических уведомлений (XAML).

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

Рекомендуется, чтобы все опрашиваемые уведомления использовали заголовок ответа X-WNS-Expires HTTP для задания явного срока действия. Дополнительные сведения об установке X-WNS-Expires см. в разделах TileUpdater.StartPeriodicUpdate и TileUpdater.StartPeriodicUpdateBatch.

Примечание В этом кратком руководстве мы работаем с содержимым уведомления непосредственно через модель DOM XML. Кроме того, это можно делать и через библиотеку NotificationsExtensions, в которой XML-содержимое представлено в форме свойств объекта, включая свойства Intellisense. Подробнее: Краткое руководство: использование библиотеки NotificationsExtensions в коде. Чтобы увидеть в этом кратком руководстве код, выраженный с помощью NotificationsExtenstions, см. Образец периодических и push-уведомлений.

Необходимые условия

Рабочая база знаний о понятиях и терминах уведомлений и плиток. Подробнее см. в разделе Плитки, индикаторы событий и уведомления.
Понимание принципов периодических уведомлений (опросов). Подробнее см. в разделе Обзор периодических уведомлений
Умение создавать простые приложения Магазина Windows на JavaScript с помощью API среды выполнения Windows. Дополнительную информацию см. в разделе Создание первого приложения Магазина Windows на JavaScript.
Веб-служба, предоставляющая удаленный доступ для содержимого плиточных уведомлений.

Инструкции

1. Создайте или укажите веб-службу, в которой должно размещаться содержимое XML плитки

Через указанный промежуток времени Windows будет выполнять опрос указанной веб-службы об обновлении содержимого для плитки вашего приложения. Эта веб-служба должна поддерживать HTTP. Чтобы проверить XML, вы также можете настроить веб-службу, например Microsoft IIS, на своем локальном компьютере.

2. Разместите ваш XML-файл содержимого плитки в месте, доступном из Интернета

Веб-служба будет размещать XML-содержимое плитки. Для начала разместите показанный здесь XML-код плитки на своем веб-сайте. Сохраните это содержимое как файл под именем "Tile.xml" и разместите файл на сервере в месте, доступном из Интернета (например, http://www.fabrikam.com/tile.xml). Содержимое XML-документа должно использовать кодировку UTF-8 и соответствовать схеме плитки. Обновляйте XML не реже, чем с периодичностью, указанной для опроса.


<tile>
  <visual version="2">
    <binding template="TileSquare150x150Text04" fallback="TileSquareText04">
      <text id="1">Hello world!</text>
    </binding>  
  </visual>
</tile>

3. Начало периодических обновлений (один URL-адрес)

В этом примере показано, как начать опрос одного URL-адреса, чтобы предоставлять новое содержимое для плитки раз в час. В этом коде используется ранее определенная переменная polledUrl — строка, указывающая опрашиваемый URL-адрес.


var notifications = Windows.UI.Notifications;
var recurrence = notifications.PeriodicUpdateRecurrence.hour;
var url = new Windows.Foundation.Uri(polledUrl);

notifications.TileUpdateManager.createTileUpdaterForApplication().startPeriodicUpdate(url, recurrence);

4. Начало периодических обновлений (несколько URL-адресов)

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

В этом примере показано, как опрашивать URL-адреса на наличие нового содержимого раз в час. Сначала необходимо включить очередь уведомлений, если вы еще не сделали это. Обратите внимание, что обращение к enableNotificationQueue нужно выполнять только один раз после того, как пользователь установит приложение или создаст вспомогательную плитку. В этом примере кода используется определенная ранее переменная urisToPoll, представляющая собой массив объектов Windows.Foundation.Uri.

Примечание Периодические обновления плиток поддерживают тег уведомления плитки, являющийся частью логики замещения очереди уведомлений. Ваша служба может устанавливать тег для каждого уведомления, предоставляя заголовок ответа HTTP X-WNS-Tag. Дополнительные сведения об использовании тегов и очереди уведомлений см. в статье Использование очереди с локальными уведомлениями. Для получения дополнительных сведений об использовании заголовка ответа HTTP X-WNS-Tag для периодических уведомлений см. TileUpdater.startPeriodicUpdateBatch.


var notifications = Windows.UI.Notifications;                        
var recurrence = notifications.PeriodicUpdateRecurrence.hour;

notifications.TileUpdateManager.createTileUpdaterForApplication().enableNotificationQueue(true);

notifications.TileUpdateManager.createTileUpdaterForApplication().startPeriodicUpdateBatch(urisToPoll, recurrence);

Краткая сводка и дальнейшие действия

В этом кратком руководстве приводится пошаговая инструкция по настройке периодического уведомления для плиток.Ту же технологию можно использовать для индикаторов событий.

Связанные разделы

Пример периодических и push-уведомлений

Руководство по периодическим уведомлениям

Как использовать очередь уведомлений при работе с локальными уведомлениями

Share via