| | |
| Nom de la propriété | Type manipulé | Effet |
|---|
| ActiveApplication | Boolé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.
|
| AffichageLED | Boolé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. |
| Badge | Entier | Numéro affiché par l'icône de l'application. |
| Catégorie | notificationCatégorie | Caté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ètre | Boolé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. |
| Contenu | Chaîne de caractères | Données personnalisées de la notification. Ces données ne sont pas affichées dans la notification. |
| CouleurLED | Entier | Couleur 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.
|
| Format | notificationFormat | Format 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é. |
| GrandeIcone | Chaîne de caractères | Chemin 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. |
| Groupe | Chaîne de caractères | Nom 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. |
| Icone | Chaîne de caractères | Chemin 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éAction | Chaîne de caractères | Libellé du bouton d'action de la notification. |
| Locale | Boolé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.
|
| Message | Chaîne de caractères | Message de la notification. |
| MessageSecondaire | Chaîne de caractères | Message 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 Entier | Priorité 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é. |
| Son | Chaîne de caractères | Chemin 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). |
| Supprimable | Boolé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éroulant | Chaîne de caractères | Texte 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é. |
| Titre | Chaîne de caractères | Titre de la notification. Si aucun titre n'est spécifié, le nom de l'application sera utilisé. |
| Vibration | Boolé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. |