Guia de início rápido: configurando notificações periódicas (HTML)

Artigo
12/12/2015

[ Este artigo destina-se aos desenvolvedores do Windows 8.x e do Windows Phone 8.x que escrevem aplicativos do Windows Runtime. Se você estiver desenvolvendo para o Windows 10, consulte documentação mais recente]

Observação Não está usando JavaScript? Veja Guia de início rápido: configurando notificações periódicas (XAML).

Este tópico mostra como iniciar a sondagem periódica de uma URL para obter o conteúdo atualizado para o bloco do seu aplicativo.

Nós recomendamos que todas as notificações sondadas usem o cabeçalho de resposta HTTP X-WNS-Expires para definir um tempo de expiração explícito. Para saber mais sobre como definir X-WNS-Expires, veja .TileUpdater.StartPeriodicUpdate ou TileUpdater.StartPeriodicUpdateBatch

Observação Neste Guia de início rápido, você vai manipular o conteúdo de notificações diretamente pelo DOM (Document Object Model) XML. Uma abordagem opcional está disponível por meio da biblioteca NotificationsExtensions, que apresenta o conteúdo XML como propriedades de objetos, incluindo o Intellisense. Para saber mais, veja Guia de início rápido: usando a biblioteca NotificationsExtensions em seu código. Para ver o código neste Guia de início rápido expresso com o uso de NotificationsExtensions, leia o Exemplo de notificações por push e periódicas.

Pré-requisitos

Um conhecimento prático dos termos e conceitos de bloco e notificação. Para saber mais, veja Blocos, emblemas e notificações.
Conhecimento sobre conceitos de notificações periódicas (sondagens). Para saber mais, confira a Visão geral de notificações periódicas.
A capacidade de criar um aplicativo básico da Windows Store em JavaScript usando as APIs do Tempo de Execução do Windows. Para saber mais, veja Criar o seu primeiro aplicativo da Windows Store em JavaScript.
Um serviço Web para hospedar o conteúdo de notificação de bloco.

Instruções

1. Crie ou identifique um serviço Web para hospedar conteúdo XML do bloco

Em um intervalo especificado, o Windows sonda o serviço Web especificado em busca do conteúdo de bloco atualizado para seu aplicativo. O serviço Web deve suportar HTTP. Para testar, você também pode configurar um serviço Web, como Microsoft ISS (Internet Information Services) em sua máquina local para testar o XML.

2. Coloque arquivo XML de conteúdo de bloco em um local acessível da Web

Um serviço Web hospeda o conteúdo XML de bloco. Para iniciar, hospede o XML de bloco mostrado aqui em seu site. Salve este conteúdo como um arquivo chamado Tile.xml e coloque o arquivo no servidor em um local acessível da Web (por exemplo, http://www.fabrikam.com/tile.xml). O conteúdo do documento XML deve usar uma codificação UTF-8 e se ajustar ao esquema de bloco. Você deve atualizar este XML, pelo menos, tão frequentemente quanto o intervalo especificado de recorrência de sondagem.


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

3. Iniciar as atualizações periódicas (URL única)

Este exemplo mostra como começar a sondagem de uma única URL para fornecer novo conteúdo ao bloco a cada hora. Este código usa uma variável anteriormente definida chamada polledUrl, que é uma cadeia de caracteres que especifica a URL a ser sondada.


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

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

4. Iniciar as atualizações periódicas (várias URLs)

Como alternativa para a etapa anterior, o Windows pode sondar até cinco URLs diferentes para fornecer um conjunto de conteúdo que percorre a fila de notificações do bloco.

Este exemplo mostra como sondar várias URLs em busca de novo conteúdo a cada hora. Em primeiro lugar, será necessário habilitar a fila de notificações se ela ainda não tiver sido habilitada. Observe que a chamada para enableNotificationQueue deve ser feita apenas uma vez, depois que o usuário instalar o aplicativo ou criar um arquivo secundário. Este código de exemplo usa uma variável anteriormente definida chamada urisToPoll, que consiste em uma matriz de objetos Windows.Foundation.Uri.

Observação Atualizações periódicas de bloco dão suporte para a marca de notificação de bloco que faz parte da lógica de substituição da fila de notificações. Seu serviço pode definir a marca em cada notificação fornecendo o cabeçalho de resposta HTTP X-WNS-Tag. Para saber mais sobre como usar marcas e a fila de notificações, veja Como usar a fila de notificações com notificações locais. Para saber mais sobre como usar o cabeçalho de resposta HTTP X-WNS-Tag com notificações periódicas, veja TileUpdater.startPeriodicUpdateBatch.


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

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

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