콘텐츠로 이동

호환성

Astral Overlay는 WebSocket과 기존 UDP로 XSOverlay 형식 알림을 받습니다. 이는 알림 호환성이며 전체 XSOverlay API 구현은 아닙니다.

  • 필수 client 쿼리 매개변수를 쓰는 로컬 포트 42070의 WebSocket.
  • SendNotification 명령과 문자열 jsonData.
  • 로컬 포트 42069의 기존 UDP 페이로드.
  • 공통 알림 텍스트, 출처, 표시 시간, 불투명도와 음량 필드.
  • 다른 WebSocket 명령은 조용히 무시합니다. 창, 테마나 상태 명령에 의존하지 마세요.
  • index와 관계없이 알림은 하나의 제한된 대기열을 공유합니다.
  • 카드 크기는 발신자가 요청한 높이 대신 내용에 따라 정해집니다.
  • 현재 수신 루프는 텍스트와 종료 프레임을 처리하며 범용 WebSocket 서비스가 아닙니다. 오래 사용하기 전에 클라이언트의 keepalive와 분할 메시지 지원을 확인하세요.
  • 파서는 audioPath, icon, useBase64Icon을 받지만 렌더러는 사용자 아이콘이나 음성 파일을 불러오지 않습니다. 자체 카드와 포함된 소리를 씁니다. 메시지별 volume은 읽지만 현재 재생에는 전체 알림 음량을 사용합니다.

두 앱은 같은 기본 알림 포트를 씁니다. 다른 앱이 포트를 점유하면 Astral Overlay는 경고를 기록하고 그 포트를 수신할 수 없습니다. 다른 통신 방식은 그 포트가 비어 있으면 계속 쓸 수 있습니다. 앱 사이에 자동 전달은 없습니다.

지원하려는 Astral Overlay 릴리스에서 연동을 시험하세요.