Bloco que obtém os dados de uma notificação push, enviada a partir do bloco servidor Enviar notificação push, e realiza alguma ação.
Figura 1 - Bloco Obter Dados de notificações push
Para utilizar esse bloco é necessário ter um projeto no Firebase e adicionar ao Cronapp o plugin Google Firebase - Push Notification. Acesse o tutorial Push notification para mais informações.
Compatibilidade
- Bloco cliente mobile: cronapi.cordova.device.getFirebaseNotificationData()
Retorno
Retorna os dados de uma notificação push.
Parâmetros
Sucesso
Executa uma ação caso os dados da notificação sejam obtidos com sucesso.
- Posição: 1
- Inglês: Success
- Tipo: Comando com retorno ("item") / Command with return ("item")
- Exemplo: uso do bloco Exibir Notificação
Erro
Executa uma ação caso ocorra um erro durante a obtenção dos dados da notificação.
- Posição: 2
- Inglês: Error
- Tipo: Comando com retorno ("item") / Command with return ("item")
- Exemplo: uso do bloco Exibir Notificação
Exemplo
Para este exemplo, criaremos duas funções de bloco de programação, uma na parte servidor do projeto e outra cliente, na aplicação mobile. No servidor será utilizada a função presente na documentação do bloco Enviar notificação push, responsável por enviar os dados da notificação ao dispositivo destinatário por meio do Firebase Cloud Messaging (FCM). Para implementar essa função, acesse a documentação do bloco correspondente.
Já na aplicação mobile, utilizaremos o bloco Obter Dados de notificação push. Esse bloco possui duas entradas de comando, que dependerá do sucesso ou erro na obtenção dos dados, para ser executada. No exemplo abaixo, em caso de sucesso, será retornado o JSON, montado no bloco servidor, contendo uma mensagem. Caso ocorra algum erro durante a obtenção das informações, o bloco Exibir Notificação exibirá uma mensagem de erro.
Figura 2 - Exemplo de uso do bloco Obter Dados de notificações push
A imagem a seguir mostra o resultado de execução da Figura 2. Caso o aplicativo esteja aberto, iremos apenas exibir um pop-up com uma mensagem Se o aplicativo estiver fechado ou em segundo plano, o usuário receberá a notificação na bandeja de notificação do Android ou iOS, ao clicar, o aplicativo será aberto e a mensagem será exibida no pop-up.
Figura 2.1 - Resultado exibido a partir das configurações da Figura 2
Nesta página