다음을 통해 공유


알림(알림 XML 스키마)

하나 이상의 시각적 요소를 포함하는 기본 알림 요소입니다.

요소 계층 구조

<토스트>

Syntax

<toast launch?   = string
      duration? = "long" | "short" 
      displayTimeStamp? = string
      scenario? = "reminder" | "alarm" | "incomingCall" | "urgent" 
      useButtonStyle? = boolean>

  <!-- Child elements -->
  visual,
  audio?,
  commands?
  actions?
  header?
</toast>

? 선택 사항(0개 또는 1개)

특성 및 요소

특성

attribute Description 데이터 형식 필수 기본값
duration

알림이 표시되어야 하는 시간입니다.

이 특성에는 다음 값 중 하나가 있을 수 있습니다.

  • long
  • short
None
시작

알림에 의해 활성화될 때 애플리케이션에 전달되는 문자열입니다. 이 문자열의 형식과 콘텐츠는 앱에서 앱 용도에 맞게 정의됩니다. 사용자가 알림을 탭하거나 클릭하여 연결된 앱을 시작할 때 시작 문자열은 기본 방식으로 시작하는 대신 사용자에게 알림 콘텐츠와 관련된 보기를 표시할 수 있는 컨텍스트를 앱에 제공합니다.

문자열 None
displayTimestamp

크리에이터스 업데이트에 도입됨: Windows 플랫폼에서 알림을 받은 시간이 아니라 알림 콘텐츠가 실제로 전달된 시간을 나타내는 사용자 지정 타임스탬프로 기본 타임스탬프를 재정의합니다. 이 값은 ISO 8601 표준을 사용하여 형식이 지정된 문자열이어야 합니다.

문자열 None
scenario

알림이 사용되는 시나리오(예: 알람 또는 미리 알림).

  • "미리 알림" - 미리 알림입니다. 미리 확장되어 표시되고 해제할 때까지 사용자의 화면에 남아 있습니다. 백그라운드에서 활성화되는 알림 단추 작업이 없는 한 자동으로 무시됩니다.
  • "알람" - 경보 알림입니다. 미리 확장되어 표시되고 해제할 때까지 사용자의 화면에 남아 있습니다. 오디오가 기본적으로 반복되고 알람 오디오를 사용합니다.
  • "incomingCall" - 들어오는 통화 알림입니다. 특별한 호출 형식으로 미리 확장되어 표시되고 해제할 때까지 사용자의 화면에 남아 있습니다. 오디오가 기본적으로 반복되고 벨소리 오디오를 사용합니다.
  • "긴급" - 중요한 알림입니다. 이를 통해 사용자는 포커스 지원(방해 금지)을 돌파할 수 있는 우선 순위가 높은 알림 메시지를 보낼 수 있는 앱을 더 많이 제어할 수 있습니다. 알림 설정에서 수정할 수 있습니다.

문자열 None
useButtonStyle

스타일이 지정된 단추를 사용할지 여부를 지정합니다. 단추의 스타일 지정은 action 요소의 **hint-buttonStyle** 특성에 의해 결정됩니다.

boolean false

 

자식 요소

자식 요소 Description
오디오

알림 메시지가 표시될 때 재생할 소리를 지정합니다. 이 요소를 사용하면 알림 메시지 오디오를 음소거할 수도 있습니다.

명령

각 시나리오와 연결된 적절한 명령을 사용하여 수신 전화 또는 알람을 나타내는 데 알림 메시지를 사용하도록 지정합니다.

Visual

알림을 정의하는 단일 바인딩 요소를 포함합니다.

actions

알림 메시지에 대해 최대 5개의 입력 및 최대 5개의 단추 작업을 선언하는 컨테이너 요소입니다.

헤더

크리에이터스 업데이트에 도입되었습니다. 알림 센터 내에서 여러 알림을 함께 그룹화하는 사용자 지정 헤더를 지정합니다.

 

부모 요소

이 가장 바깥쪽(문서) 요소는 다른 요소에 포함되지 않을 수 있습니다.

추가 정보