콘텐츠로 이동

알림 필드

다음 필드는 알림 페이로드에 속합니다. 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의 이전 이름, 0이 아닌 값이 우선

title과 content 중 적어도 하나에는 공백이 아닌 텍스트가 필요합니다. 잘못된 JSON과 빈 알림은 버립니다.

필드가 없을 때 기본값을 씁니다. 명시적인 0은 보존한 뒤 범위를 제한합니다. 예를 들어 timeout: 0은 0.5초가 되고 opacity: 0은 0으로 남습니다.

카드는 간결한 본문을 쓰며 긴 메시지는 잘라 냅니다. 요청한 픽셀 높이나 여러 카드 동시 표시를 전제로 하지 마세요.

파서가 받는 필드라고 XSOverlay 전체 기능을 지원하는 것은 아닙니다. 사용자 아이콘이나 오디오에 의존하기 전에 호환성 페이지를 읽으세요.