Guia de início rápido: configurando notificações periódicas
Recolher sumário
Expandir sumário
Idioma: HTML | XAML

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

[ 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 C#/VB/C++? Veja Guia de início rápido: configurando notificações periódicas (HTML).
 

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

Para ver versões em JavaScript dos exemplos apresentados neste Guia rápido, consulte Como configurar notificações periódicas para blocos (JavaScript).

Convém que todas as notificações periódicas 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

Instruções

1. Criar ou identificar 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.



using Windows.UI.Notifications;

PeriodicUpdateRecurrence recurrence = PeriodicUpdateRecurrence.Hour;
System.Uri url = new System.Uri(polledUrl);

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 bloco secundário. Este código de exemplo usa uma variável previamente definida denominada urisToPoll, que é uma matriz de objetos de URL, cada qual representando uma URL diferente a partir da qual obter conteúdo sondado.

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ção, veja Como usar a fila de notificação 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.
 


using Windows.UI.Notifications;

TileUpdateManager.CreateTileUpdaterForApplication().EnableNotificationQueue(true);

PeriodicUpdateRecurrence recurrence = PeriodicUpdateRecurrence.Hour;
TileUpdateManager.CreateTileUpdaterForApplication().StartPeriodicUpdateBatch(urisToPoll, recurrence);

Resumo e próximas etapas

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:
© 2017 Microsoft