Guia de início rápido: adicionando notificações por push para um serviço móvel (JavaScript)
[ 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]
Esse Guia rápido conduz você para habilitar notificações por push em um aplicativo dos Serviços Móveis do Azure. Os Serviços Móveis tornam fácil o envio de notificações por push para seu aplicativo usando os Serviços de Notificação por Push do Windows (WNS). Para saber mais, veja o Centro de desenvolvimento dos Serviços Móveis. Se você possui o Microsoft Visual Studio 2013, fica fácil habilitar notificações por push em seu aplicativo de Serviços Móveis. Esse tópico está integrado ao tópico anterior Guia de início rápido: adicionando um serviço móvel. Quando tiver feito isso, você terá adicionado notificações por push para seu novo serviço móvel e já terá testado o aplicativo enviando uma nova notificação.
Pré-requisitos
- Visual Studio 2013 Atualização 3**
- Uma conta da Windows Store ativa.
- Conclua o tópico em Guia de início rápido: adicionar um serviço móvel anterior.
Adicione e configure notificações por push no aplicativo
Primeiro, use o assistente para Adicionar Notificação por Push no Visual Studio 2013 para registrar seu aplicativo com a Windows Store, configure seu serviço móvel para habilitar notificações por push e adicione código a seu aplicativo para registrar um canal do dispositivo.
Observação Este tópico presume que uma conexão do serviço móvel já tenha sido estabelecida para o projeto, que foi feito no tópico anterior. Quando um serviço móvel não foi conectado, o assistente para Adicionar Notificação por Push cria essa conexão para você.
- Em Visual Studio 2013, abra o Gerenciador de Soluções, clique como botão direito no projeto e clique em Adicionar, em seguida, Notificação por Push.... Isso inicia o Assistente para Adicionar Notificação por Push.
- Clique em Avançar, conecte sua conta da Windows Store, depois forneça um nome em Reservar um novo nome e clique em Reservar. Isso cria um novo registro de aplicativo na Windows Store.
- Clique no novo registro na lista Nome do aplicativo, então clique em Avançar.
- Selecione o serviço móvel que você criou quando concluiu Guia de início rápido: adicionando um serviço móvel ou Guia de início rápido: adicionando um serviço móvel usando C++, clique em Avançar, em seguida, clique em Concluir. Isso configura seu serviço móvel para trabalhar com Serviços de Notificação por Push do Windows (WNS) e poder enviar notificações para seu aplicativo.Observação Quando seu aplicativo ainda não está configurado para conectar ao serviço móvel, o assistente também conclui as mesmas tarefas de configuração demonstradas em Guia de início rápido: adicionando um serviço móvel.
- (Opcional) Abra o arquivo de código YourMobileService.push.register.js gerado e inspecione o código. Este código assegura que o registro do dispositivo será tentado sempre que o aplicativo for ativado, e inclui uma chamada para a API personalizada notifyallusers.
- (Opcional) No Gerenciador de Servidores, expanda Serviços Móveis, o nome de seu serviço, e abra o arquivo notifyallusers. js. Esse arquivo, que é armazenado em seu serviço móvel, contém o código JavaScript que envia notificações por push para todos os usuários registrados.
- Pressione a tecla F5 para executar o aplicativo e verifique se uma notificação é imediatamente recebida do serviço móvel.
Atualizar o código de notificação por push gerado
O Assistente para Adicionar Notificação por Push adiciona o código que dispara uma notificação de teste para todos os usuários registrados. Embora isso facilite demonstrar uma notificação quando o aplicativo é executado, no geral esse não é um cenário significativo. Dessa forma, você removerá a chamada para notifyallusers e a substituirá, com algumas alterações, pelo código que envia uma notificação para todos os dispositivos registrados quando uma inserção é feita na tabela TodoItem.
No Gerenciador de Servidores, expanda Serviços Móveis, o nome do seu serviço e, em seguida, notifyallusers. js. Ele contém código que envia uma notificação por push. Observação O código que envia uma notificação por push pode ser incluído em qualquer arquivo de script registrado. A localização desse script depende de como a notificação é disparada. Scripts podem ser registrados mediante uma inserção, atualização, exclusão ou operação de leitura em uma tabela; como uma tarefa agendada; ou uma API personalizada. Para obter mais informações, consulte Trabalhar com scripts de servidor em Serviços Móveis. Nesse caso, esse código é movido para o script registrado mediante uma operação de inserção na tabela TodoItem.
Expanda a tabela TodoItem, abra o arquivo Insert. js e substitua a função de inserção atual pelo código a seguir, em seguida, salve suas alterações:
function insert(item, user, request) { // Define a payload for the Windows Store toast notification. var payload = '<?xml version="1.0" encoding="utf-8"?><toast><visual>' + '<binding template="ToastText01"> <text id="1">' + item.text + '</text></binding></visual></toast>'; request.execute({ success: function() { // If the insert succeeds, send a notification. push.wns.send(null, payload, 'wns/toast', { success: function(pushResponse) { console.log("Sent push:", pushResponse); request.respond(); }, error: function (pushResponse) { console.log("Error Sending push:", pushResponse); request.respond(500, { error: pushResponse }); } }); } }); }Quando você salva alterações no arquivo Insert js, uma nova versão do script é carregada para seu serviço móvel.
Agora, quando você inserir um novo TodoItem, uma nova notificação por push será enviada de volta imediatamente para o dispositivo que fez a solicitação de inserção.
No Visual Studio, pressione a tecla F5 para executar o aplicativo.
No aplicativo, digite o texto Inserir um TodoItem, e depois clique em Salvar. Observe que uma notificação é imediatamente enviada de volta para o dispositivo depois que a inserção é feita na tabela em Azure.
(Opcional) Execute o aplicativo em duas máquinas ao mesmo tempo, e repita a etapa anterior. Verifique se a notificação é enviada a todas as instâncias de aplicativo em execução.
Resumo e próximas etapas
Agora você sabe como usar os Serviços Móveis para adicionar funcionalidade de notificações por push para seu aplicativo da Windows Store.
Em seguida, considere aprender como usar os Serviços Móveis para Autenticar usuários usando os provedores de identidade da conta Microsoft, Facebook, Twitter ou Google. Para saber mais, veja Iniciar com autenticação.