Referência do conteúdo
Estes campos pertencem aos dados de notificação: dentro da string JSON do envelope WebSocket ou diretamente em um datagrama UDP.
| Campo | Tipo | Padrão quando omitido | Comportamento |
|---|---|---|---|
title |
string | vazio | Cabeçalho da notificação |
content |
string | vazio | Corpo da notificação |
sourceApp |
string | vazio | Identificação do remetente |
timeout |
number | 5 | Segundos; limitado entre 0.5 e 60 |
opacity |
number | 1 | Limitado entre 0 e 1 |
volume |
number | 1 | Lido e limitado entre 0 e 1; a reprodução atual usa o volume global |
audioPath |
string | vazio | Lido por compatibilidade; carregamento de recursos personalizados não implementado |
icon |
string | vazio | Lido por compatibilidade; carregamento de recursos personalizados não implementado |
useBase64Icon |
boolean | false | Lido por compatibilidade; carregamento de recursos personalizados não implementado |
height |
integer | 0 | Mantido por compatibilidade; o cartão segue o conteúdo |
index |
integer | 0 | Mantido por compatibilidade; não cria pilhas de notificações separadas |
type |
integer | 0 | Tipo de notificação |
messageType |
integer | 0 | Nome antigo de type; um valor diferente de zero tem precedência |
Pelo menos um entre title e content precisa conter texto além de espaços. JSON inválido e notificações vazias são descartados.
Valores ausentes e zero explícito
Seção intitulada “Valores ausentes e zero explícito”Os padrões valem quando um campo está ausente. Zero explícito é preservado e depois limitado: timeout: 0 vira 0.5 segundo, enquanto opacity: 0 permanece zero.
Apresentação
Seção intitulada “Apresentação”O cartão usa um corpo compacto e trunca mensagens longas. Não dependa de uma altura solicitada em pixels ou de vários cartões ao mesmo tempo.
Campos aceitos pelo analisador não implicam suporte total ao XSOverlay. Leia a compatibilidade antes de depender de ícones ou áudio personalizados.