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 instance 반환합니다.

특성

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 instance 반환합니다.

특성

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 스키마에 대한 참조 정보는 앱 알림 콘텐츠 스키마를 참조하세요.