Idioma: HTML | XAML

Guia de início rápido: enviando uma atualização de notificação (HTML)

Applies to Windows and Windows Phone

Observação  Não está usando JavaScript? Veja Guia de início rápido: enviando uma atualização de notificação (XAML).

Este tópico mostra como criar ou atualizar uma notificação de bloco. Você vai enviar uma notificação que inclui um glifo ou um valor numérico. Você verá também como remover a notificação do bloco.

Uma notificação é um número ou glifo exibido no bloco para indicar o status de um aplicativo de alguma maneira. Uma notificação é uma sobreposição no bloco; ela não faz parte do bloco propriamente dito. Pode aparecer em diversos lugares no bloco:

  • No canto inferior direito no Windows usando um idioma da esquerda para a direita, como o inglês
  • No canto inferior esquerdo no Windows usando um idioma da direita para a esquerda, como o árabe
  • No canto superior direito no Windows Phone 8.1 usando um idioma da esquerda para a direita
  • No canto superior esquerdo no Windows Phone 8.1 usando um idioma da direita para a esquerda

A notificação é manipulada por suas próprias APIs e esquema e é atualizada através de suas notificações. Este tópico percorre com você pelo procedimento de definição do conteúdo de notificação, do envio desse conteúdo por meio de uma notificação e da remoção do conteúdo quando ele deixa de ser necessário. Estas ações são demonstradas através de uma notificação local, que é a notificação mais simples para implementação.

Observação  Neste tópico, 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 expresso com o uso de NotificationsExtensions, veja o Exemplo de blocos e notificações de aplicativos.

Pré-requisitos

Para entender este tópico, você precisa de:

Instruções

1. Opcional: declarar uma variável de namespace

Esta etapa fornece a você um nome abreviado para uso no lugar do nome completo do namespace. Isso equivale à instrução "using" em C# ou à instrução "Imports" no Visual Basic. Permite simplificar seu código.

Observação  O restante do código neste tópico presume que essa variável tenha sido declarada.


var notifications = Windows.UI.Notifications;

2. Escolher quando exibir um número ou um glifo

O selo exibe números de 0 a 99 ou um conjunto de glifos de status definidos pelo sistema. A notificação escolhida depende do cenário. Por exemplo, um programa de email exibe o número de emails não lidos ou o glifo "nova mensagem" quando chegam novos emails. Para saber mais sobre os glifos disponíveis, veja Visão geral de notificação. Para saber mais sobre quando usar números ou glifos, veja Diretrizes e lista de verificação de blocos e notificações.

  • Applies to Windows Phone

Desde o Windows Phone 8.1, somente glifos de status “alerta” e “atenção”, assim como números, são permitidos para notificações de telefone. O envio de outros glifos para o telefone apagará a notificação.

Notificações numeradas e notificações com glifo são definidas por meio de modelos de notificação específicos para cada. Recupere o modelo adequado ao tipo de notificação que você escolheu. Este exemplo recupera o modelo de uma notificação numérica.



var badgeType = notifications.BadgeTemplateType.badgeNumber;
var badgeXml = notifications.BadgeUpdateManager.getTemplateContent(badgeType);

Este exemplo recupera o modelo de uma notificação com glifo.



var badgeType = notifications.BadgeTemplateType.badgeGlyph;
var badgeXml = notifications.BadgeUpdateManager.getTemplateContent(badgeType);

3. Atribua um valor à notificação

Este exemplo recupera o elemento badge do modelo e atribui a ele um valor numérico.



var badgeAttributes = badgeXml.getElementsByTagName("badge");
badgeAttributes[0].setAttribute("value", "7");

Este exemplo atribui um valor de glifo à notificação.



var badgeAttributes = badgeXml.getElementsByTagName("badge");
badgeAttributes[0].setAttribute("value", "newMessage");

4. Crie a notificação e envie-a

Este exemplo empacota o XML definido em uma notificação e o envia para a notificação.



var badgeNotification = new notifications.BadgeNotification(badgeXml);
notifications.BadgeUpdateManager.createBadgeUpdaterForApplication().update(badgeNotification);

5. Opcional: limpe a notificação quando ela não for mais válida

Quando a informação transmitida pelo número ou glifo da notificação estiver desatualizada, ou não for mais útil, remova a notificação. O código a seguir remove a notificação atual do bloco do aplicativo de chamada. Você também pode enviar o valor "nenhum" como uma atualização de notificação no lugar de chamar o método Limpar.

Observação  Diferentemente dos blocos, uma notificação pode ser apagada na nuvem.


notifications.BadgeUpdateManager.createBadgeUpdaterForApplication().clear();

Resumo e próximas etapas

Neste Guia de início rápido, você definiu e enviou um novo conteúdo para uma notificação no bloco de seu aplicativo e a removeu quando deixou de ser válida.

Este Guia de início rápido enviou a atualização de notificação como uma notificação local. Você também pode explorar os outros métodos de entrega de notificações: agendadas, periódicas e por push. Para saber mais, veja Entregando notificações.

Tópicos relacionados

Visão geral das notificações
Esquema de notificações
BadgeTemplateType
BadgeNotification
Guia de início rápido: configurando notificações periódicas

 

 

Mostrar:
© 2015 Microsoft