Перейти к содержимому

Поля уведомления

Эти поля относятся к данным уведомления: внутри строки JSON конверта WebSocket или прямо в UDP-датаграмме.

Поле Тип Значение при отсутствии Поведение
title string пусто Заголовок уведомления
content string пусто Текст уведомления
sourceApp string пусто Подпись отправителя
timeout number 5 Секунды; ограничение от 0.5 до 60
opacity number 1 Ограничение от 0 до 1
volume number 1 Читается и ограничивается от 0 до 1; сейчас воспроизведение использует общую громкость
audioPath string пусто Читается для совместимости; загрузка своих ресурсов не реализована
icon string пусто Читается для совместимости; загрузка своих ресурсов не реализована
useBase64Icon boolean false Читается для совместимости; загрузка своих ресурсов не реализована
height integer 0 Сохраняется для совместимости; размер карточки зависит от содержимого
index integer 0 Сохраняется для совместимости; не создаёт отдельные стеки
type integer 0 Вид уведомления
messageType integer 0 Старое имя type; ненулевое значение имеет приоритет

Хотя бы одно из title и content должно содержать не только пробельные символы. Неверный JSON и пустые уведомления отбрасываются.

Стандартные значения применяются к отсутствующему полю. Явный ноль сохраняется, затем ограничивается: например, timeout: 0 становится 0.5 секунды, а opacity: 0 остаётся нулём.

Карточка использует компактный текст с обрезкой длинных сообщений. Не рассчитывайте на запрошенную высоту в пикселях или одновременное появление нескольких карточек.

Принятие поля парсером не означает полной поддержки XSOverlay. Прочитайте страницу совместимости перед использованием собственных иконок или звука.