DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions spécifiques Mobile / Fonctions de gestion du téléphone
  • Utilisation du type Notification
  • Exemple de notification sous Android
  • Propriétés spécifiques à la description des variables de type Notification pour une notification push
  • Fonctions utilisant le type Notification
  • Réinitialisation
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Le type Notification permet de manipuler
  • les notifications en push.
Les caractéristiques de cette notification peuvent être définies et modifiées à l'aide de différentes propriétés WLangage.
Remarque : Pour plus de détails sur la déclaration de ce type de variable et l'utilisation des propriétés WLangage, consultez Déclaration d'une variable.
Exemple
// Notification simple
// --------------------
notif est une Notification
notif.Titre = "Nouveau message reçu"
notif.Message = "Cliquez pour afficher le message"
NotifAjoute(notif)
Remarques

Utilisation du type Notification

Le type Notification est utilisé pour la gestion des notifications locales et pour la gestion des notifications push.
Cette page d'aide présente :

Exemple de notification sous Android

Les différents éléments de cette notification sont configurables grâce au type Notification :
  • 1. Grande icône de la notification (propriété GrandeIcone).
  • 2. Titre de la notification (propriété Titre).
  • 3. Message de la notification (propriété Message).
  • 4. Message secondaire (propriété MessageSecondaire).
  • 5. Heure de réception de la notification (propriété Chronomètre).
  • 6. Icône de l'application (propriété Icone).
  • 7. Actions supplémentaires de la notification (propriété ActionSupplémentaire).

Propriétés spécifiques à la description des variables de type Notification pour une notification push

Les propriétés suivantes peuvent être utilisées pour manipuler une notification :
Nom de la propriétéType manipuléEffet
ActiveApplicationBooléen
  • Vrai si l'application doit être mise au premier plan lors du clic sur la notification.
  • Faux (valeur par défaut) dans le cas contraire.
AffichageLEDBooléen
  • Vrai si la LED de l'appareil doit être allumée lors de l'affichage de la notification,
  • Faux (valeur par défaut) dans le cas contraire.
La couleur et la fréquence d'allumage de la LED peuvent varier d'un appareil à l'autre.
BadgeEntierNuméro affiché par l'icône de l'application.
CatégorienotificationCatégorieCatégorie associée à la notification. Les catégories de notification sont disponibles à partir d'Android 8.0 (API level 26). Si l'application s'exécute sur une version plus ancienne la propriété Catégorie sera ignorée.
Il est conseillé de toujours associer une catégorie à une notification
  • Si la catégorie n'existe pas au moment de l'ajout de la notification, elle sera automatiquement créée,
  • Si la catégorie existe déjà pour l'application, la notification sera associée à la catégorie existante.
  • Si aucune catégorie n'a été spécifiée, la notification sera automatiquement associée à une catégorie prédéfinie en fonction de son niveau de priorité. Les catégories prédéfinies sont les suivantes :
    • Priorité min.
    • Priorité faible
    • Priorité normale
    • Priorité élevée
    • Priorité max.
    La catégorie prédéfinie sera créée lors du premier ajout d'une notification sans catégorie avec le niveau de priorité correspondant et utilisera les paramètres visuels et auditifs de cette notification (vibreur, son, led, ...). Ces paramètres pourront ensuite être modifiés par l'utilisateur final. Si la catégorie prédéfinie existe déjà, la notification héritera des propriétés de cette catégorie.
ChronomètreBooléen
  • Vrai pour afficher un chronomètre à la place de l'heure de la notification. Le chronomètre démarrera automatiquement lors de la réception de la notification et son affichage sera mis à jour automatiquement.
  • Faux (valeur par défaut) pour ne pas afficher de chronomètre. L'heure associée à la notification sera affichée.
Attention : L'affichage d'un chronomètre dans les notifications est disponible à partir de Android 4.1 (Jelly Bean, api level 16). Sur des appareils en version inférieure, le chronomètre sera ignoré et l'heure associée à la notification sera affichée.
ContenuChaîne de caractèresDonnées personnalisées de la notification. Ces données ne sont pas affichées dans la notification.
CouleurLEDEntierCouleur de la LED lors de l'affichage de la notification.
La valeur de cette propriété est prise en compte uniquement si la propriété AffichageLED vaut Vrai.
Par défaut, la couleur d'affichage de la LED est verte.
Cette couleur peut correspondre à :
Attention : Certains appareils ne permettent pas de modifier la couleur de la LED ou ne proposent que certaines couleurs. Si la couleur spécifiée n'est pas supportée par l'appareil, une couleur par défaut sera utilisée.
FormatnotificationFormatFormat d'affichage de la notification lorsque celle-ci est déroulée.
Attention : L'affichage des notifications en mode "déroulé" est disponible uniquement à partir de Android 4.1 (Jelly Bean, api level 16). Sur des appareils en version inférieure, le format d'affichage sera ignoré.
GrandeIconeChaîne de caractèresChemin de l'image correspondant à la grande icône associée à la notification. Cette icône sera affichée à gauche du titre et du message de la notification.
Si aucune image n'est spécifiée, l'icône spécifiée par la propriété Icone sera utilisée. Si cette dernière n'est pas spécifiée, l'icône de l'application sera utilisée.
Attention : L'affichage de cette image dans les notifications est possible uniquement pour les appareils disposant d'Android 3.0 ou supérieure (Honeycomb, api level 11). Sur des appareils en version inférieure, cette image sera ignorée.
GroupeChaîne de caractèresNom du groupe auquel est associée la notification push.
Si plusieurs notifications push appartenant au même groupe sont envoyées avec un contenu identique alors que l'appareil destination ne peut être joint, lorsque l'appareil sera à nouveau contacté par le serveur Google Cloud Messaging, seule la dernière notification du groupe sera envoyée.
IconeChaîne de caractèresChemin de l'image correspondant à l'icône associée à la notification.
Si aucune icône n'est spécifiée, l'icône de l'application sera utilisée.
LibelléActionChaîne de caractèresLibellé du bouton d'action de la notification.
LocaleBooléen
  • Vrai si la notification est locale à l'appareil qui la reçoit : cette notification ne doit pas être transmise aux objets fonctionnant sous Android Wear connectés à l'appareil (par exemple, une montre).
  • Faux (valeur par défaut) si la notification doit être transmise automatiquement aux objets connectés.
MessageChaîne de caractèresMessage de la notification.
MessageSecondaireChaîne de caractèresMessage secondaire affiché en dessous du message principal de la notification.
Attention : L'affichage d'un message secondaire dans les notifications est disponible à partir de Android 4.1 (Jelly Bean, api level 16). Sur des appareils en version inférieure, le message secondaire sera ignoré.
PrioritéConstante de type EntierPriorité de la notification.
Le changement de priorité d'une notification permet de modifier sa position d'affichage dans la liste des notifications de l'appareil afin que l'utilisateur puisse voir les notifications les plus importantes en premier. Une notification avec une priorité élevée sera affichée au début de la liste alors qu'une notification avec une priorité faible sera affichée en fin de liste.
Dans certaines situations, une notification avec une priorité faible peut être masquée à l'utilisateur si d'autres notifications avec des priorités plus élevées sont reçues.
Cette propriété peut prendre les valeurs suivantes  :
  • notifPrioritéMax : priorité maximale (exemple : appel entrant).
  • notifPrioritéElévée : priorité élevée (exemple : réception d'un email urgent).
  • notifPrioritéDéfaut (valeur par défaut) : priorité normale (exemple  : réception d'un SMS).
  • notifPrioritéFaible : priorité faible (exemple  : notification de mise à jour).
  • notifPrioritéMin : priorité minimale (exemple  : information commerciale).
La modification des priorités des notifications est possible uniquement à partir de Android 4.1 (Jelly Bean, api level 16). Sur des appareils en version inférieure, la priorité sera ignorée : toutes les notifications ont la même priorité.
SonChaîne de caractèresChemin du fichier son à jouer lors de l'affichage de la notification.
Pour jouer le son par défaut des notifications, utilisez la constante notifSonDéfaut. Ce son par défaut peut varier d'un appareil à l'autre.
Il est possible de jouer un son issu d'un fichier audio intégré à l'application (via l'assistant de génération) : il suffit d'indiquer le nom de fichier et son extension.
Pour ne pas associer de son à la notification, utilisez la valeur chaîne vide ("", valeur par défaut).
SupprimableBooléen
  • Vrai (valeur par défaut) si la notification peut être supprimée par l'utilisateur,
  • Faux dans le cas contraire.
Si cette propriété vaut Faux, la notification sera effacée uniquement dans les cas suivants :
  • Fermeture de l'application.
  • Appel de la fonction NotifSupprime.
  • Si la procédure WLangage exécutée lors du clic (propriété ActionClic) a retourné Vrai ou n'a pas retourné de valeur.
TexteDéroulantChaîne de caractèresTexte déroulant affiché furtivement dans la barre système lors de l'affichage de la notification.
Si cette propriété vaut chaîne vide ("", valeur par défaut), aucun message ne sera affiché.
TitreChaîne de caractèresTitre de la notification.
Si aucun titre n'est spécifié, le nom de l'application sera utilisé.
VibrationBooléen
  • Vrai si l'appareil doit vibrer lors de l'affichage de la notification,
  • Faux (valeur par défaut) dans le cas contraire.
Remarque : La durée et la puissance des vibrations peuvent varier d'un appareil à l'autre.

Fonctions utilisant le type Notification

Les fonctions suivantes manipulent les variables de type Notification pour une notification locale :
NotifAjouteAjoute une notification dans la barre système de l'appareil (Android) ou dans le centre de notification (iOS).
NotifModifieModifie une notification actuellement affichée dans la barre système de l'appareil.
NotifPushEnvoieEnvoie une notification push (distante) à un appareil mobile (iOS ou Android).
NotifSupprimeSupprime une notification affichée dans la barre système de l'appareil.
ThreadPersistantRend un thread persistant.

Réinitialisation

Pour réinitialiser le contenu d'une variable de type Notification, il est possible d'utiliser la fonction VariableRAZ.
Liste des exemples associés :
WM Push Exemples multiplateforme : WM Push
[ + ] Cet exemple montre comment recevoir des notifications Push.
Il appelle la fonction NotifPushActive et envoie l'identifiant obtenu à l'exemple WINDEV "WD Serveur Push" afin qu'il le stocke.
Cet identifiant est ensuite lu par l'exemple WINDEV "Envoi Push" afin qu'il envoie les notifications en push à cet exemple.
WD_Serveur_Push Exemples multiplateforme : WD_Serveur_Push
[ + ] Cet exemple est un webservice servant à stocker les identifiants nécessaires au Push sur mobiles.
L'application WINDEV Mobile WM Push stockent les identifiants Push dans la base de cet exemple.
Ces identifiants sont ensuite lus par l'exemple "WD Envoi Push" afin qu'il envoie les notifications.
Envoi Push Exemples multiplateforme : Envoi Push
[ + ] Cet exemple permet d'envoyer des notifications en push sur des appareils Android et iOS.
Il récupère les identifiants des mobiles dans la base HFSQL de l'exemple "WD Serveur Push", et leur envoie ensuite les notifications grâce à la fonction NotifPushEnvoie.
WM Système Exemples multiplateforme (WINDEV Mobile) : WM Système
[ + ] Cette application est un exemple didactique montrant quelques unes des fonctionnalités de WINDEV Mobile pour Android/iOS.
Les fonctions système utilisées sont :
- NFC
- Champ Multimédia
- Luminosité
- Volume
- WIFI
- Bluetooth
- Toast
- Boussole
- Accéléromètre
- Champ caméra
- LED
- Vibrations
- Notifications
- Fonctions de dessin
- Internet
Version minimum requise
  • Version 16
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale