Guia de início rápido: mostrando as atualizações de bloco e notificação na tela de bloqueio (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]
Este tópico explica como habilitar o aplicativo para mostrar notificações e notificações de bloco na tela de bloqueio. Observe que não há procedimento especial para enviar uma notificação para a tela de bloqueio. As notificações mostradas na tela de bloqueio são as mesmas notificações mostradas na tela inicial. Notificações do sistema aparecem na tela de bloqueio sem nenhuma configuração especial.
Pré-requisitos
Para entender este tópico, você precisa de:
- Um conhecimento prático dos termos e conceitos de bloco e notificação. Para saber mais, veja Blocos, selos e notificações.
- Familiaridade com o esquema XML de bloco. Para saber mais, veja Esquema de blocos.
- 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.
- Um bloco padrão existente para o seu aplicativo, definido no manifesto do aplicativo. Para saber mais, veja Guia de início rápido: criando um bloco padrão usando o Editor de Manifesto do Microsoft Visual Studio.
- Familiaridade com o XML e sua manipulação por meio de APIs DOM (Document Object Model).
Instruções
1. Declarar o tipo de presença de tela de bloqueio para o aplicativo
Os recursos de tela de bloqueio são declarados no arquivo package.appxmanifest do aplicativo. Se você usa o editor de manifesto do Visual Studio, é só escolher a opção Notificações de tela de bloqueio apropriada na guia Aplicativo.
O exemplo a seguir mostra o XML que é inserido no arquivo package.appxmanifest como resultado da seleção de opção. O elemento LockScreen é adicionado como um nó filho do elemento VisualElements do manifesto.
O XML mostrado aqui é também o que você usa para criar o arquivo package.appxmanifest diretamente, fora do Visual Studio. Para saber mais, veja Como criar um manifesto de pacote manualmente.
<VisualElements
...
<LockScreen Notification="badge" BadgeLogo="images\logo-lockscreen.png"/>
...
</VisualElements>
<VisualElements
...
<LockScreen Notification="badgeAndTileText" BadgeLogo="images\logo-lockscreen.png"/>
...
</VisualElements>
2. Declarar uma imagem de logotipo de emblema
O exemplo a seguir mostra a declaração XML do atributo BadgeLogo do elemento LockScreen. Mais uma vez, observe que você define esse valor em geral no Visual Studio, e não manualmente. Para saber mais sobre os requisitos de imagem, veja Visão geral dos aplicativos da tela de bloqueio.
<VisualElements
...
<LockScreen Notification="badge" BadgeLogo="images\logo-lockscreen.png"/>
...
</VisualElements>
3. Declarar uma tarefa em segundo plano
Um aplicativo com uma presença na tela de bloqueio deve declarar um dos seguintes tipos de tarefas no tela de fundo:
- Canal de controle (Windows somente)
- Temporizador
- Notificação por push
No Visual Studio, esse valor é definido na página Declarações do editor de manifesto.
- Escolha "Tarefas em segundo plano" na lista suspensa.
- Clique no botão Add.
- Selecione os itens apropriados na lista Propriedades e adicione quaisquer outras informações exigidas pelas suas seleções.
No XML do manifesto, esse valor é declarado no elemento BackgroundTasks.
Para saber mais sobre tarefas em tela de fundo, veja Introdução a tarefas em tela de fundo.
4. Especificar um logotipo largo
Se você especificar o valor badgeAndTileText na Etapa 1, deve especificar uma imagem de logotipo largo como parte do bloco padrão do aplicativo. Se o usuário definiu seu bloco na tela de bloqueio e escolheu mostrar o status detalhado, um bloco largo será usado. Os blocos grandes e médios não são usados na tela de bloqueio; portanto as notificações de bloco enviadas sem um vínculo grande não são vistas na tela de bloqueio.
Você pode especificar uma imagem de logotipo larga através do editor de manifesto do Visual Studio ou do XML do manifesto, como mostrado aqui.
<VisualElements
...
<DefaultTile ShortName="Tiles JS" ShowName="allLogos" WideLogo="images\tile-sdk.png"/>
...
</VisualElements>
Resumo e próximas etapas
Depois de concluir as etapas acima, seu bloco é um candidato a ser mostrado na tela de bloqueio, caso o usuário decida mostrá-lo. Depois do procedimento detalhado neste tópico, seu aplicativo será listado como aplicativo de tela de bloqueio nas Configurações do dispositivo. O usuário tem a escolha final sobre qual daqueles aplicativos será mostrado na tela de bloqueio, e qual será o que mostrará o status detalhado através de texto.
Tópicos relacionados
Visão geral da tela de bloqueio