Référence du contenu
Ces champs appartiennent au contenu de notification : dans la chaîne JSON de l’enveloppe WebSocket, ou directement dans un datagramme UDP.
| Champ | Type | Valeur par défaut si absent | Comportement |
|---|---|---|---|
title |
string | vide | Titre de la notification |
content |
string | vide | Corps de la notification |
sourceApp |
string | vide | Libellé de l’émetteur |
timeout |
number | 5 | Secondes ; limité de 0.5 à 60 |
opacity |
number | 1 | Limité de 0 à 1 |
volume |
number | 1 | Lu et limité de 0 à 1 ; la lecture actuelle utilise le volume sonore global |
audioPath |
string | vide | Lu pour compatibilité ; le chargement de ressources personnalisées n’est pas implémenté |
icon |
string | vide | Lu pour compatibilité ; le chargement de ressources personnalisées n’est pas implémenté |
useBase64Icon |
boolean | false | Lu pour compatibilité ; le chargement de ressources personnalisées n’est pas implémenté |
height |
integer | 0 | Conservé pour compatibilité ; la disposition de la carte suit son contenu |
index |
integer | 0 | Conservé pour compatibilité ; ne crée pas de piles de notifications distinctes |
type |
integer | 0 | Catégorie de notification |
messageType |
integer | 0 | Ancienne écriture de type ; une valeur non nulle est prioritaire |
Au moins l’un des champs title ou content doit contenir du texte autre que des espaces. Le JSON non valide et les notifications vides sont ignorés.
Valeurs absentes et zéro explicite
Section intitulée « Valeurs absentes et zéro explicite »Les valeurs par défaut s’appliquent lorsqu’un champ est absent. Un zéro explicite est conservé puis limité : par exemple, timeout: 0 devient 0.5 seconde, tandis que opacity: 0 reste nul.
Présentation
Section intitulée « Présentation »La carte utilise un corps compact avec troncature des messages longs. Ne comptez pas sur une hauteur en pixels demandée ni sur l’affichage simultané de plusieurs cartes.
L’acceptation d’un champ par le parseur n’implique pas forcément la prise en charge complète des fonctions XSOverlay. Lisez la page de compatibilité avant de dépendre d’icônes ou de sons personnalisés.