다음을 통해 공유


audio(Toast XML 스키마)

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

요소 계층 구조

<토스트>
<오디오>

Syntax

<audio src?    = string
       loop?   = boolean
       silent? = boolean />

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

특성 및 요소

특성

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

알림이 표시되는 한 소리가 반복되어야 하는 경우 true 로 설정합니다. false 이면 한 번만 재생됩니다. 이 특성이 true로 설정된 경우 알림 요소의 기간 특성도 설정해야 합니다. 반복할 때 사용할 특정 소리가 제공됩니다. UWP 앱은 오디오 반복이나 장시간 알림을 지원하지 않습니다.

boolean false
침묵

소리를 음소거하려면 True입니다. 알림 메시지 소리가 재생되도록 하려면 false입니다.

boolean false
src

기본 소리 대신 재생할 미디어 파일입니다. Windows 이 특성은 다음 문자열 값 중 하나를 가질 수 있습니다.

  • ms-winsoundevent:Notification.Default
  • ms-winsoundevent:Notification.IM
  • ms-winsoundevent:Notification.Mail
  • ms-winsoundevent:Notification.Reminder
  • ms-winsoundevent:Notification.SMS
  • ms-winsoundevent:Notification.Looping.Alarm
  • ms-winsoundevent:Notification.Looping.Alarm2
  • ms-winsoundevent:Notification.Looping.Alarm3
  • ms-winsoundevent:Notification.Looping.Alarm4
  • ms-winsoundevent:Notification.Looping.Alarm5
  • ms-winsoundevent:Notification.Looping.Alarm6
  • ms-winsoundevent:Notification.Looping.Alarm7
  • ms-winsoundevent:Notification.Looping.Alarm8
  • ms-winsoundevent:Notification.Looping.Alarm9
  • ms-winsoundevent:Notification.Looping.Alarm10
  • ms-winsoundevent:Notification.Looping.Call
  • ms-winsoundevent:Notification.Looping.Call2
  • ms-winsoundevent:Notification.Looping.Call3
  • ms-winsoundevent:Notification.Looping.Call4
  • ms-winsoundevent:Notification.Looping.Call5
  • ms-winsoundevent:Notification.Looping.Call6
  • ms-winsoundevent:Notification.Looping.Call7
  • ms-winsoundevent:Notification.Looping.Call8
  • ms-winsoundevent:Notification.Looping.Call9
  • ms-winsoundevent:Notification.Looping.Call10

사용자 지정 소리에 대한 자세한 내용은 설명 섹션을 참조하세요.

문자열 None

 

자식 요소

없음

부모 요소

부모 요소 Description
토스트

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

 

설명

데스크톱 플랫폼을 대상으로 하는 UWP 앱은 Windows 10 버전 1511(빌드 10586) 이상에서 사용자 지정 알림 메시지 소리를 지원합니다. 이전 버전에서는 위의 표에서 src 특성에 대해 나열된 값 목록에서 ms-winsoundevent 선택할 수 있습니다. 사용자 지정 알림 메시지 소리에 대한 자세한 내용은 알림의 사용자 지정 오디오를 참조하세요.

앱 페이로드에서 사용자 지정 파일 경로를 지정하면 지정된 시나리오에 따라 기본 소리(알림, 통화, 경보 또는 미리 알림)가 재생됩니다.

다음 코드는 이 태그의 예를 보여줍니다.

<audio src="ms-winsoundevent:Notification.Mail" loop="false"/>
                

다음 코드는 알림 메시지 오디오를 음소거하는 데 사용되는 이 태그를 보여줍니다.

<audio silent="true"/>
                

참고 항목