Partilhar via

Visão geral da notificação periódica

As notificações periódicas, que também são chamadas de notificações sondadas, atualizam blocos e selos em um intervalo fixo, baixando conteúdo de um serviço de nuvem. Para usar notificações periódicas, o código do aplicativo cliente precisa fornecer duas informações:

  • O URI (Uniform Resource Identifier) de um local da Web que o Windows utiliza para pesquisar atualizações de bloco ou símbolo para a sua aplicação
  • Com que frequência esse URI deve ser pesquisado

As notificações periódicas permitem que seu aplicativo obtenha atualizações de blocos dinâmicos com o mínimo de serviço de nuvem e investimento do cliente. As notificações periódicas são um bom método de entrega para distribuir o mesmo conteúdo para um público amplo.

Observação Você pode saber mais baixando o exemplo de notificações por push e periódicas para Windows 8.1 e reutilizando seu código-fonte em seu aplicativo do Windows 10.

 

Como funciona

As notificações periódicas exigem que seu aplicativo hospede um serviço de nuvem. O serviço será pesquisado periodicamente por todos os usuários que tiverem o aplicativo instalado. Em cada intervalo de sondagem, como uma vez por hora, o Windows envia uma solicitação HTTP GET para o URI, baixa o conteúdo do bloco ou selo solicitado (como XML) fornecido em resposta à solicitação e exibe o conteúdo no bloco do aplicativo.

Note que não é possível usar atualizações periódicas com notificações por pop-up. A melhor forma de fornecer "toast" é através de notificações agendadas ou notificações push .

Localização do URI e conteúdo XML

Qualquer endereço Web HTTP ou HTTPS válido pode ser usado como o URI a ser pesquisado.

A resposta do servidor na nuvem inclui o conteúdo transferido. O conteúdo retornado do URI deve estar em conformidade com a especificação do esquema XML Tile ou Badge e deve ser codificado em UTF-8. Você pode usar cabeçalhos HTTP definidos para especificar o tempo de expiração ou a etiqueta para a notificação.

Comportamento nas sondagens

Chame um destes métodos para iniciar a sondagem:

Quando chamas um destes métodos, o URI é imediatamente consultado e o azulejo ou selo é atualizado com o conteúdo recebido. Após essa pesquisa inicial, o Windows continua a fornecer atualizações no intervalo solicitado. A sondagem continua até que você a pare explicitamente (com TileUpdater.StopPeriodicUpdate), seu aplicativo é desinstalado ou, no caso de um bloco secundário, o bloco é removido. Caso contrário, o Windows continuará a procurar atualizações para o seu mosaico ou emblema, mesmo que a sua aplicação nunca mais seja iniciada.

O intervalo de recorrência

Você especifica o intervalo de recorrência como um parâmetro dos métodos listados acima. Observe que, embora o Windows faça um esforço melhor para sondar conforme solicitado, o intervalo não é preciso. O intervalo de votação solicitado pode ser atrasado em até 15 minutos, a critério do Windows.

A hora de início

Opcionalmente, você pode especificar um horário específico do dia para iniciar a votação. Considere uma aplicação que altera o seu conteúdo de azulejo apenas uma vez por dia. Nesse caso, recomendamos que você faça uma pesquisa perto do momento em que atualiza seu serviço de nuvem. Por exemplo, se um site de compras diário publicar as ofertas do dia às 8h, verifique novos conteúdos de interface logo após as 8h.

Se forneceres uma hora de início, a primeira chamada do método irá sondar o conteúdo imediatamente. Em seguida, a votação regular começa dentro de 15 minutos da hora de início fornecida.

Comportamento de repetição automática

O URI é pesquisado somente se o dispositivo estiver online. Se a rede estiver disponível, mas o URI não puder ser contatado por qualquer motivo, essa iteração do intervalo de sondagem será ignorada e o URI será sondado novamente no próximo intervalo. Se o dispositivo estiver em um estado desligado, em suspensão ou hibernado quando um intervalo de sondagem for atingido, o URI será sondado quando o dispositivo retornar de seu estado desligado ou de suspensão.

Gerindo atualizações de aplicativos

Se libertar uma atualização de aplicativo que altere o seu URI de sondagem, deverá adicionar uma tarefa em segundo plano de acionamento diário que chame StartPeriodicUpdate com o novo URI para se certificar de que os seus blocos dinâmicos estão a usar o novo URI. Caso contrário, se os utilizadores receberem a atualização da aplicação mas não a iniciarem, os tiles ainda usarão o URI antigo, que poderá não ser exibido se o URI for inválido ou se o conteúdo retornado fizer referência a imagens locais que não existam mais.

Expiração de notificações de mosaico e emblema

Por padrão, as notificações periódicas de bloco e emblema expiram três dias desde que são baixadas. Quando uma notificação expira, o conteúdo é removido do selo, bloco ou fila e não é mais mostrado ao usuário. É uma prática recomendada definir um tempo de expiração explícito em todas as notificações periódicas de bloco e selo, usando um tempo que faça sentido para seu aplicativo ou notificação, para garantir que o conteúdo não persista por mais tempo do que é relevante. Um tempo de expiração explícito é essencial para conteúdos com um tempo de vida definido. Ele também garante a remoção de conteúdo obsoleto se o seu serviço de nuvem se tornar inacessível ou se o usuário se desconectar da rede por um longo período de tempo.

Seu serviço de nuvem define uma data e hora de expiração para uma notificação, incluindo o cabeçalho HTTP X-WNS-Expires na carga útil de resposta. O cabeçalho HTTP X-WNS-Expires está em conformidade com o formato HTTP-date. Para obter mais informações, consulte StartPeriodicUpdate ou StartPeriodicUpdateBatch.

Por exemplo, durante o dia de negociação ativo de um mercado de ações, você pode definir o vencimento de uma atualização do preço de uma ação para o dobro do seu intervalo de sondagem (como uma hora após o recebimento se você estiver pesquisando a cada meia hora). Como outro exemplo, um aplicativo de notícias pode determinar que um dia é um tempo de expiração apropriado para uma atualização diária do bloco de notícias.

Notificações periódicas na fila de notificações

Você pode usar atualizações periódicas de mosaico com ciclagem de notificações. Por padrão, um bloco na tela inicial mostra o conteúdo de uma única notificação até que seja substituído por uma nova notificação. Quando você habilita o ciclismo, até cinco notificações são mantidas em uma fila e o bloco percorre-as.

Se a fila tiver atingido sua capacidade de cinco notificações, a próxima nova notificação substituirá a notificação mais antiga na fila. No entanto, ao definir tags em suas notificações, você pode afetar a política de substituição da fila. Uma tag é uma cadeia de caracteres específica do aplicativo, que não diferencia maiúsculas de minúsculas, de até 16 caracteres alfanuméricos, especificada no cabeçalho X-WNS-Tag HTTP na carga da resposta. O Windows compara a tag de uma notificação de entrada com as tags de todas as notificações já na fila. Se for encontrada uma correspondência, a nova notificação substitui a notificação em fila pela mesma etiqueta. Se nenhuma correspondência for encontrada, a regra de substituição padrão será aplicada e a nova notificação substituirá a notificação mais antiga na fila.

Você pode usar o enfileiramento de notificações e a marcação para implementar uma variedade de cenários de notificação avançados. Por exemplo, uma aplicação de ações pode enviar cinco notificações, cada sobre uma ação diferente e cada uma marcada com um nome de ação. Isso evita que a fila contenha duas notificações para o mesmo estoque, sendo que a mais antiga está desatualizada.

Para obter mais informações, consulte Usando a fila de notificações.

Ativando a fila de notificações

Para implementar uma fila de notificações, primeiro habilite a fila para seu bloco (consulte Como usar a fila de notificações com notificações locais). A chamada para habilitar a fila precisa ser feita apenas uma vez durante a vida útil do aplicativo, mas não há nenhum dano em chamá-la cada vez que o aplicativo é iniciado.

Consultar mais de uma notificação ao mesmo tempo

Tem de fornecer um URI exclusivo para cada notificação que pretende que o Windows transfira para o mosaico. Usando o método StartPeriodicUpdateBatch , você pode fornecer até cinco URIs de uma só vez para uso com a fila de notificações. Cada URI é sondado para um único pacote de notificação, ao mesmo tempo ou quase ao mesmo tempo. Cada URI pesquisado pode retornar sua própria expiração e valor de tag.

  • Last updated on