Notifications

AppStudio AppFramework fournit un plug-in de notifications qui contient des outils pour alerter et informer les utilisateurs de votre application au niveau du système d'exploitation en dehors du cadre de votre application.

Pour voir un exemple de cette fonctionnalité, consultez l'application d’exemple disponible dans ArcGIS AppStudio ou dans le référentiel GitHub d’exemples AppStudio.

Notifications locales

Le composant LocalNotification (notification locale) offre la possibilité d’envoyer des notifications à vos utilisateurs finaux. Ceci ne doit pas être confondu avec les notifications Push qui proviennent d’un service cloud externe, les notifications locales proviennent de l’application et sont déclenchées en interne. Pour utiliser le composant LocalNotification (notification locale), vous devez tout d’abord inclure l’instruction d’import suivante :

import ArcGIS.AppFramework.Notifications.Local 1.0

Une notification locale requiert les trois paramètres suivants pour être planifiée :

• Le titre du message
• Le contenu du message
• Le délai après lequel la notification s’affiche, mesuré en millisecondes.

Ces paramètres sont gérés par la méthode schedule (planification), qui définit le déclenchement de la notification une fois le nombre de millisecondes écoulé et fournit un ID pour la notification qui peut être utilisé par la méthode clear (effacer) pour la supprimer.

Lorsqu’une notification a été planifiée, il n’est pas nécessaire que l’application soit en focus ni même en cours d’exécution pour que la notification soit affichée. L’exemple de code suivant est basé sur le modèle Quick Report et utilise la LocalNotification (notification locale), définissant l’affichage d’une notification une heure après l’envoi du rapport, pour rappeler à l’utilisateur d'envoyer un rapport de suivi :

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();
        }
    }
}

Vibration

Outre les notifications locales qui fournissent une forme visible de notification, vous pouvez également mettre en œuvre un retour non visuel à l’aide du composant Vibration. La vibration est couramment utilisée pour mettre en évidence des actions ou avertir l’utilisateur de quelque chose, mais elle est plus habituellement utilisée conjointement à une notification afin d’informer l’utilisateur de consulter son appareil. Pour utiliser le composant Vibration, vous devez tout d’abord inclure l’instruction d’import suivante :

import ArcGIS.AppFramework.Notifications 1.0

La vibration est un composant singleton, ce qui signifie que vous ne pouvez pas l’instancier. L’exemple de code suivant accompagne d’une vibration toutes les notifications locales planifiées par l’application. Si l’appareil ne prend pas en charge la vibration, un message apparaît dans le journal de console.

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

Actuellement, il n’est pas possible de définir une durée pour le composant Vibration. Sur les appareils Android, la vibration dure une seconde ; sur les autres appareils, sa durée est déterminée par les paramètres par défaut du système.