AppNotificationBuilder.SetAudioUri 메서드

정의

네임스페이스:

Microsoft.Windows.AppNotifications.Builder

오버로드

SetAudioUri(Uri)	앱 알림이 표시될 때 재생되는 사운드 파일을 설정합니다.
SetAudioUri(Uri, AppNotificationAudioLooping)	앱 알림이 표시될 때 재생되는 소리 파일 및 오디오 반복 동작을 설정합니다.

SetAudioUri(Uri)

앱 알림이 표시될 때 재생되는 사운드 파일을 설정합니다.

public:
 virtual AppNotificationBuilder ^ SetAudioUri(Uri ^ audioUri) = SetAudioUri;

/// [Windows.Foundation.Metadata.Overload("SetAudioUri")]
AppNotificationBuilder SetAudioUri(Uri const& audioUri);

[Windows.Foundation.Metadata.Overload("SetAudioUri")]
public AppNotificationBuilder SetAudioUri(System.Uri audioUri);

function setAudioUri(audioUri)

Public Function SetAudioUri (audioUri As Uri) As AppNotificationBuilder

매개 변수

audioUri

Uri Uri

오디오 파일의 URI입니다.

반환

AppNotificationBuilder

추가 메서드 호출을 연결할 수 있도록 AppNotificationBuilder 인스턴스를 반환합니다.

특성

OverloadAttribute

예제

다음 예제에서는 앱 알림에 대한 XML 페이로드에서 오디오 URI를 설정하는 방법을 보여 줍니다.

var notification = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetAudioUri(new Uri("ms-appx:///Audio/NotificationSound.mp3"))
    .BuildNotification();


AppNotificationManager.Default.Show(notification);

결과 XML 페이로드:

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Notification text.</text>
        </binding>
    </visual>
    <audio src='ms-appx:///Audio/NotificationSound.mp3'/>
</toast>

설명

지원되는 오디오 파일 형식은 다음과 같습니다.

• .aac
• .flac
• .m4a
• .mp3
• .wav
• .wma

지원되는 오디오 파일 원본은 다음과 같습니다.

• ms-appx:///
• ms-resource

지원되지 않는 오디오 파일 원본은 다음과 같습니다.

• ms-appdata
• http:// 같은 인터넷 URL은 https://
• C:/, F:/등과 같은 절대 파일 경로입니다.

SetAudioEvent호출하여 시스템 정의 사운드를 재생하는 사운드 이벤트를 지정할 수 있습니다.

AppNotificationBuilder API를 사용하여 앱 알림에 대한 UI를 만드는 방법에 대한 지침은 앱 알림 콘텐츠참조하세요.

앱 알림에 대한 XML 스키마에 대한 참조 정보는 앱 알림 콘텐츠 스키마참조하세요.

SetAudioUri(Uri, AppNotificationAudioLooping)

앱 알림이 표시될 때 재생되는 소리 파일 및 오디오 반복 동작을 설정합니다.

public:
 virtual AppNotificationBuilder ^ SetAudioUri(Uri ^ audioUri, AppNotificationAudioLooping loop) = SetAudioUri;

/// [Windows.Foundation.Metadata.Overload("SetAudioUri2")]
AppNotificationBuilder SetAudioUri(Uri const& audioUri, AppNotificationAudioLooping const& loop);

[Windows.Foundation.Metadata.Overload("SetAudioUri2")]
public AppNotificationBuilder SetAudioUri(System.Uri audioUri, AppNotificationAudioLooping loop);

function setAudioUri(audioUri, loop)

Public Function SetAudioUri (audioUri As Uri, loop As AppNotificationAudioLooping) As AppNotificationBuilder

매개 변수

audioUri

Uri Uri

오디오 파일의 URI입니다.

loop

AppNotificationAudioLooping

오디오의 반복 동작을 지정하는 AppNotificationAudioLooping 열거형의 멤버입니다.

반환

AppNotificationBuilder

추가 메서드 호출을 연결할 수 있도록 AppNotificationBuilder 인스턴스를 반환합니다.

특성

OverloadAttribute

예제

다음 예제에서는 앱 알림에 대한 XML 페이로드에서 오디오 URI를 설정하는 방법을 보여 줍니다.

var notification = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetAudioUri(new Uri("ms-appx:///Audio/NotificationSound.mp3"), AppNotificationAudioLooping.Loop)
    .BuildNotification();


AppNotificationManager.Default.Show(notification);

결과 XML 페이로드:

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Notification text.</text>
        </binding>
    </visual>
    <audio src='ms-appx:///Audio/NotificationSound.mp3'/>
</toast>

설명

지원되는 오디오 파일 형식은 다음과 같습니다.

• .aac
• .flac
• .m4a
• .mp3
• .wav
• .wma

지원되는 오디오 파일 원본은 다음과 같습니다.

• ms-appx:///
• ms-resource

지원되지 않는 오디오 파일 원본은 다음과 같습니다.

• ms-appdata
• http:// 같은 인터넷 URL은 https://
• C:/, F:/등과 같은 절대 파일 경로입니다.

SetAudioEvent호출하여 시스템 정의 사운드를 재생하는 사운드 이벤트를 지정할 수 있습니다.

AppNotificationBuilder API를 사용하여 앱 알림에 대한 UI를 만드는 방법에 대한 지침은 앱 알림 콘텐츠참조하세요.

앱 알림에 대한 XML 스키마에 대한 참조 정보는 앱 알림 콘텐츠 스키마참조하세요.