通知字段
这些字段属于通知内容，位于 WebSocket 信封的 JSON 字符串中，或直接放在 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 和空通知会被丢弃。
缺失值与显式零值
Section titled “缺失值与显式零值”字段缺失时采用默认值。显式零值会被保留后再限制范围：例如 timeout: 0 变为 0.5 秒，而 opacity: 0 保持为零。
卡片采用紧凑正文，长消息会被截断。不要依赖请求的像素高度或多个卡片同时出现。
解析器接受字段并不代表完整支持 XSOverlay 功能。在依赖自定义图标或音频前，请阅读兼容性页面。