Notificações

O AppStudio AppFramework fornece um complemento de Notificações que contém ferramentas para alertar e informar os usuários do seu aplicativo no nível do sistema operacional fora da margem do seu aplicativo.

Para obter um exemplo desta funcionalidade, consulte o aplicativo de amostra disponível em ArcGIS AppStudio ou no repositório de GitHub das amostras do AppStudio.

Notificações locais

O componente LocalNotification fornece o recurso de implementar notificações para seus usuários finais. Não deve ser confundido com notificações de saída, que provêm de um serviço externo da nuvem, as notificações locais provêm do aplicativo e são ativadas internamente. Para utilizar o componente LocalNotification, primeiro você precisa incluir a seguinte declaração de importação:

import ArcGIS.AppFramework.Notifications.Local 1.0

Uma notificação local exige que os seguintes três parâmetros sejam agendados:

• O título da mensagem.
• O conteúdo da mensagem.
• O atraso de tempo após o qual a notificação será exibida, medido em milissegundos.

Estes parâmetros são tratados pelo método schedule , que define a notificação para ativar após o determinado número de milissegundos e fornece um ID para a notificação que pode ser utilizada pelo método clear para removê-lo.

Após uma notificação ser agendada, o aplicativo não precisa estar focado ou mesmo executando para que a notificação seja exibida. A seguinte amostra de código é baseada no modelo de Relatório Rápido e utiliza LocalNotification, definindo uma notificação para aparecer uma hora após o envio de um relatório, para lembrar ao usuário de enviar um relatório de acompanhamento:

LocalNotification {
    id: notification
    onTriggered: {
        console.log("Triggered ID: ", id)
    }
}
Component {
    id: addDetailsPage
    AddDetailsPage {
        onNext: {
            if(message=="submit"){
                submitReport()
                notification.schedule("Submit Follow-Up Report", "An hour has passed since your initial report. Please send a follow-up report.", 3600000)
            } else{
                stackView.showResultsPage()
                saveReport()
            }
        }
        onPrevious: {
            stackView.pop();
        }
    }
}

Vibração

Além das notificações locais que fornecem uma forma visível de notificação, você também pode implementar um comentário não visual utilizando o componente Vibração. A vibração é comumente utilizada para destacar ações ou notificar o usuário, mas o uso mais comum está em conjunto com uma notificação para alertar o usuário para visualizar seu dispositivo. Para utilizar o componente Vibração, inclua a seguinte declaração de importação:

import ArcGIS.AppFramework.Notifications 1.0

Vibração é um componente único, o que significa que você não pode instanciá-lo. A seguinte amostra de código acompanhará todas as notificações locais agendadas pelo aplicativo com uma vibração. Se o dispositivo não suportar a vibração, uma mensagem aparecerá no registro do console.

LocalNotification {
    id: notification
    onTriggered: {
        console.log("Triggered ID: ", id)
        if(Vibration.supported) {
            Vibration.vibrate()
        }
        else{
            console.log("Vibration not supported on this device.")
        }
    }
}

Atualmente, não há nenhuma maneira de fornecer uma duração para o componente de Vibração. Em dispositivos Android, a vibração dura um segundo; em outros dispositivos, ela utiliza o padrão de sistema.