Guia de início rápido: configurando notificações periódicas (aplicativos da Windows Store em JavaScript e HTML)

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.

Para ver as versões em C#, C++ ou Visual Basic dos exemplos de JavaScript apresentados neste Guia rápido, consulte Configurando notificações periódicas (C#, C++ ou Visual Basic.

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.
  • Noções básicas sobre notificações periódicas (sondagens). Para saber mais, confira a Visão geral de notificações periódicas.
  • Capacidade de criar um aplicativo da Windows Store básico com JavaScript usando as APIs do Tempo de Execução do Windows.
  • 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 da Web especificado em busca do conteúdo de bloco atualizado para seu aplicativo. O serviço da Web deve suportar HTTP. Para testar, você também pode configurar um serviço da 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 na 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="TileWide310x150Text03" fallback="TileWideText03">
      <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);

Este Guia de início rápido o orientou pela configuração de uma notificação periódica de bloco.A mesma técnica pode ser usada em selos.

Tópicos relacionados

Envio e exemplo de notificações periódicas
Diretrizes para notificações periódicas
Como usar a fila de notificações com notificações locais

 

 

Mostrar:
© 2014 Microsoft. Todos os direitos reservados.