Referencia del contenido
Estos campos pertenecen a los datos de la notificación: dentro de la cadena JSON del sobre WebSocket o directamente en un datagrama UDP.
| Campo | Tipo | Valor si se omite | Comportamiento |
|---|---|---|---|
title |
string | vacío | Encabezado de la notificación |
content |
string | vacío | Cuerpo de la notificación |
sourceApp |
string | vacío | Etiqueta del emisor |
timeout |
number | 5 | Segundos; limitado entre 0.5 y 60 |
opacity |
number | 1 | Limitado entre 0 y 1 |
volume |
number | 1 | Se lee y limita entre 0 y 1; la reproducción usa actualmente el volumen global |
audioPath |
string | vacío | Se lee por compatibilidad; no se implementa la carga de recursos personalizados |
icon |
string | vacío | Se lee por compatibilidad; no se implementa la carga de recursos personalizados |
useBase64Icon |
boolean | false | Se lee por compatibilidad; no se implementa la carga de recursos personalizados |
height |
integer | 0 | Conservado por compatibilidad; la tarjeta sigue su contenido |
index |
integer | 0 | Conservado por compatibilidad; no crea pilas separadas |
type |
integer | 0 | Tipo de notificación |
messageType |
integer | 0 | Nombre antiguo de type; un valor distinto de cero tiene prioridad |
Al menos uno de title y content debe contener texto que no sea solo espacios. Se descartan el JSON inválido y las notificaciones vacías.
Valores ausentes y cero explícito
Sección titulada «Valores ausentes y cero explícito»Los valores predeterminados se aplican si falta un campo. Un cero explícito se conserva y después se limita: por ejemplo, timeout: 0 pasa a 0.5 segundos, mientras opacity: 0 sigue siendo cero.
Presentación
Sección titulada «Presentación»La tarjeta tiene un cuerpo compacto que trunca mensajes largos. No dependas de una altura en píxeles solicitada ni de varias tarjetas simultáneas.
Que el analizador acepte un campo no implica soporte completo de XSOverlay. Lee la página de compatibilidad antes de depender de iconos o audio personalizados.