Como escolher notificações do sistema (aplicativos do Tempo de Execução do Windows)

[ 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 Como aceitar notificações do sistema (XAML).

Este tópico explica como especificar se seu aplicativo é capaz de emitir notificações do sistema.

O que você precisa saber

Tecnologias

• Windows Runtime

Pré-requisitos

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

• Um conhecimento prático dos termos e conceitos de notificações do sistema. Para saber mais, veja Visão geral das notificações do sistema.
• Familiaridade com o esquema XML de notificação do sistema e um conhecimento geral de XML e sua manipulação através de APIs DOM (Document Object Model). Para saber mais, veja Esquema de notificações do sistema.

Instruções

Etapa 1: Declarar a capacidade de notificações do sistema

A capacidade de emitir notificações do sistema é declarada no arquivo package.appxmanifest. Se você usa o editor de manifesto do Microsoft Visual Studio, basta definir a opção Compatível com Toast como "Sim" na seção Notificações da guia Aplicativo.

O exemplo a seguir mostra o XML que é inserido no arquivo package.appxmanifest como resultado da opção escolhida. O atributo ToastCapable é adicionado ao elemento VisualElements do manifesto.

Este exemplo mostra também o que você precisa adicionar ao criar o arquivo package.appxmanifest manualmente, fora do Visual Studio. Para obter mais informações, veja Como criar um manifesto de pacote manualmente. Embora a opção do Visual Studio seja "Sim", o que aparece escrito no arquivo package.appxmanifest é "true".

<VisualElements 
    ...
    ToastCapable="true">
</VisualElements>

Etapa 2: Declarar uma cor de tela de fundo e de texto para suas notificações do sistema (somente Windows)

Você pode declarar uma cor da tela de fundo e texto claro ou escuro para a notificação do sistema. Observe que essa configuração também se aplica aos blocos —as cores de texto e da tela de fundo das notificações de bloco e do sistema são sempre vinculadas.

Se você usa o editor de manifesto do Visual Studio, selecione a opção Texto em primeiro plano na guia Ativos visuais. Defina a opção Cor do plano de fundo com uma cadeia de cores W3DC (por exemplo, "#FFFFFF").

Observação  Os aplicativos da Loja do Windows Phone não permitem que você defina uma cor de texto ou de tela de fundo. A cor da tela de fundo de notificação do sistema é a cor de destaque do sistema, que pode ser escolhida pelo usuário em Configurações, e o texto é sempre claro.

O exemplo a seguir mostra o XML que é inserido no arquivo package.appxmanifest como resultado das opções escolhidas. Os atributos ForegroundText e BackgroundColor são adicionados ao elemento VisualElements do manifesto.

<VisualElements 
    ...
    ForegroundText="dark" 
    BackgroundColor="#FFFFFF">
</VisualElements>

Etapa 3: Especificar uma imagem de logotipo

A imagem de logotipo pequeno do aplicativo é exibida no canto inferior direito de cada notificação do sistema, para indicar ao usuário qual aplicativo a emitiu.

Observação  O Windows Phone 8.1 does não usa essa imagem de logotipo. O bloco mostra somente o nome de exibição do aplicativo (informado no manifesto) ou nada.

Se você usa o editor de manifesto do Visual Studio, defina o caminho de imagem Logotipo quadrado de 30x30 (Windows) ou o Logotipo quadrado de 44x44 (Windows Phone) na guia Ativos visuais. A imagem especificada deve ser incluída no pacote do aplicativo.

O exemplo a seguir mostra o XML que é inserido no arquivo package.appxmanifest como resultado das opções escolhidas. O atributo SmallLogo é adicionado ao elemento VisualElements do manifesto.

<VisualElements 
    ...
    SmallLogo="images\smallTile-sdk.png">
</VisualElements>

Comentários

Depois de concluir as etapas anteriores, seu aplicativo poderá enviar notificações do sistema ao usuário.

Exemplo completo

O exemplo a seguir mostra o XML completo para o elemento VisualElements de um aplicativo do Windows de exemplo em seu arquivo package.appxmanifest, incluindo os atributos discutidos neste tópico.

<VisualElements 
    DisplayName="ToastsSample" 
    Logo="images\squareTile-sdk.png" 
    SmallLogo="images\smallTile-sdk.png" 
    Description="SDK Sample" 
    ForegroundText="dark" 
    BackgroundColor="#FFFFFF" 
    ToastCapable="true">
    <DefaultTile ShortName="ToastsSample" ShowName="allLogos"/>
    <SplashScreen BackgroundColor="white" Image="images\splash-sdk.png"/>
</VisualElements>

Tópicos relacionados

Visão geral das notificações do sistema

Diretrizes e lista de verificação para notificações do sistema

Exemplo de notificações do sistema