Trabalhando com blocos, selos e notificações do sistema (HTML)

[ 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 Trabalhando com blocos, selos e notificações do sistema (XAML).

 

Os tópicos contidos nesta seção demonstram tarefas práticas comuns que você executará ao projetar blocos, atualizar esses blocos e seus destaques por meio de notificações, projetar e enviar notificações do sistema e interagir com a tela de bloqueio.

Nestes tópicos, nós explicaremos os seguintes elementos:

  • Blocos: a representação de um aplicativo na tela inicial. Os blocos são "dinâmicos", pois o conteúdo exibido se modifica em resposta às notificações. Um aplicativo também pode ter um ou mais blocos secundários, que incluem links diretos para modos de exibição ou experiências específicos dentro do aplicativo.
  • Selos: mostrados nos blocos para indicar o estado ou status do aplicativo. Você pode definir o selo para mostrar um número ou uma pequena imagem (glifo), dependendo da informação que deseja passar.
  • Notificações do sistema, que são notificações pop-up específicas do aplicativo.

Cada um desses elementos pode ser atualizado por vários mecanismos de notificação:

  • Notificações locais, que usam somente texto e imagens apresentados no dispositivo. Essas notificações podem aparecer conforme a necessidade ou podem ser agendadas para um horário específico.
  • Notificações periódicas: usam texto e imagens recuperados regularmente de um serviço baseado em nuvem.
  • Notificações por push, que enviam texto e imagens de um servidor em nuvem para o dispositivo do usuário por meio dos Serviços de Notificação por Push do Windows (WNS).

O que você encontrará em ambas as notificações de criação e envio é que o código para cada tipo de notificação (bloco, selo ou notificação do sistema) segue um padrão similar e definido de APIs. Geralmente, a diferença entre cada uma delas não passa de uma mudança no nome da classe. Essa regularidade de padrões de codificação acelera sua familiaridade com esses recursos. Se você sabe como enviar uma notificação por push a um bloco, também vai saber como enviar uma notificação por push de selo ou do sistema.

Esses tópicos pressupõem que você esteja familiarizado com os conceitos e a terminologia de blocos e notificações. Para saber mais, acesse as visões gerais em Blocos, selos e notificações.

A maior parte do código nestes tópicos é tirada de amostras baixadas do Windows. Para ver o código no lugar e alterar e treinar, visite Amostras de aplicativo da Windows Store que poderá ajudá-lo.

Nesta seção

Tópico Descrição

Usando NotificationsExtensions

A biblioteca de modelos de objetos NotificationsExtensions permite fornecer conteúdo de modelos XML de bloco, selo e notificação do sistema, sem usar o DOM (Document Object Model) XML. Isso oferece a você um método mais simples, mais nítido e mais direto de fornecer conteúdo de notificação.

Criando blocos e notificações

Esta seção mostra como definir o conteúdo do bloco ou selo e enviá-lo como uma notificação. O conteúdo usa notificações locais, que são as notificações mais simples para implementação. Depois de compreender as noções básicas sobre blocos e selos, você vai poder aplicar esse conhecimento para enviar notificações através de outros métodos de entrega: agendado, periódico e por push.

Fixando blocos secundários

Esta seção mostra como usar blocos secundários, que permitem a um usuário fixar experiências ou conteúdos específicos de um aplicativo na tela inicial para que ele tenha acesso direto a eles.

Enviando notificações do sistema

Esta seção mostra como definir e enviar uma notificação do sistema, que é uma notificação pop-up que permite que seu aplicativo se comunique com o usuário quando o usuário estiver em outro aplicativo, na tela inicial ou na área de trabalho. Essas ações são demonstradas com o uso de notificações locais, que são as notificações mais simples para implementação. Depois de compreender as noções básicas sobre construção e uso de notificações do sistema, você vai poder aplicar esse conhecimento para enviar notificações através de outros métodos de entrega: agendado, periódico e por push.

Entregando notificações

Os exemplos apresentados nas seções Criando blocos e notificações e Enviando notificações do sistema demonstram o uso de notificações locais. As notificações locais permitem atualizar blocos e notificações e enviar notificações do sistema durante a execução do aplicativo, usando recursos de texto e imagem armazenados no dispositivo no qual o aplicativo está sendo executado. Esta seção estende as informações para abordar outros dispositivos que estão disponíveis a você para especificar o conteúdo do bloco, do selo e da notificação do sistema: notificações agendadas, periódicas e por push.

Solução de problemas de bloco, notificação do sistema e selo

Este tópico descreve as etapas iniciais de solução de problemas caso você tenha problemas com blocos, notificações do sistema e selos, incluindo os diversos métodos de notificação: notificações locais, por push, periódicas e agendadas.