跳转到内容
Astral Overlay logoAstral Overlay

兼容性

Astral Overlay 通过 WebSocket 和旧版 UDP 接受 XSOverlay 风格的通知。这是通知兼容性，并非实现完整的 XSOverlay API。

支持的入口

Section titled “支持的入口”
  • 本地端口 42070 的 WebSocket，必须包含 client 查询参数。
  • SendNotification 命令和字符串形式的 jsonData。
  • 本地端口 42069 的旧版 UDP 内容。
  • 共用的通知文字、来源、显示时间、不透明度和音量字段。

限制

Section titled “限制”
  • 其他 WebSocket 命令会被静默忽略。不要依赖窗口、主题或状态命令。
  • 通知共享一个有上限的队列，不受 index 影响。
  • 卡片尺寸取决于内容，而非发送方请求的高度。
  • 当前 WebSocket 接收循环处理文本帧和关闭帧，不提供通用 WebSocket 服务。长期使用前，请验证客户端所需的保活和分片消息支持。
  • 解析器接受 audioPath、icon 和 useBase64Icon，但渲染器不加载自定义通知图标或音频文件。它使用自有卡片样式和内置声音。逐条消息的 volume 会被解析，当前播放仍采用全局通知音量。

与 XSOverlay 同时运行

Section titled “与 XSOverlay 同时运行”

两款应用使用相同的默认通知端口。如果其他应用已占用某端口，Astral Overlay 会记录警告，并无法监听该端口。另一种传输方式在其自身端口空闲时仍可能可用。应用之间不会自动转发。

请针对打算支持的 Astral Overlay 发行版本测试集成。