Guia de início rápido: enviando uma atualização de notificação (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 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 de selo que inclui um glifo ou um valor numérico. Você vai ver também como remover o selo 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:
- Um conhecimento prático dos termos e conceitos de selo e notificação. Para saber mais, veja Blocos, selos e notificações.
- Familiaridade com o esquema XML de selo. Para saber mais, veja Esquema de notificações.
- A capacidade de criar um aplicativo da Windows Store básico com JavaScript usando as APIs do Tempo de Execução do Windows. Para saber mais, veja Criar o seu primeiro aplicativo da Windows Store em JavaScript.
- Familiaridade com o XML e sua manipulação por meio de APIs DOM (Document Object Model).
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.
Observação 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 para um selo numérico.
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: limpar o selo quando ele não for mais válido
Quando a informação passada pelo número ou glifo do selo estiver desatualizada ou não for mais útil, remova o selo. Quando a informação passada pelo número ou glifo do selo estiver desatualizada ou não for mais útil, remova o selo. 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 ao selo no bloco de seu aplicativo e o removeu depois que não era mais válido.
Este Guia de início rápido enviou a atualização de selo 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.