Share via

알림에 대한 사용자 지정 오디오

  • 아티클

알림 메시지는 앱이 브랜드의 고유한 사운드 효과를 나타낼 수 있도록 사용자 지정 오디오를 사용할 수 있습니다. 예를 들어 메시지 앱은 일반 알림 사운드보다는 알림 메시지에서 자체 메시지 사운드를 사용할 수 있으므로 사용자는 앱의 알림을 수신하는 즉시 알 수 있습니다.

UWP 커뮤니티 도구 키트 NuGet 패키지 설치

코드를 통해 알림을 만들려면 알림 XML 콘텐츠를 제공하는 UWP 커뮤니티 도구 키트 알림 라이브러리를 사용하는 것이 가장 좋습니다. 수동으로 알림 XML을 구성할 수 있지만 오류가 발생하기 쉽고 지저분합니다. UWP 커뮤니티 도구 키트의 알림 라이브러리는 Microsoft에서 알림을 소유한 팀에서 빌드하고 유지합니다.

NuGet에서 Microsoft.Toolkit.Uwp.Notifications를 설치합니다.

네임스페이스 선언 추가

using Microsoft.Toolkit.Uwp.Notifications;

사용자 지정 오디오 추가

Windows Mobile은 항상 알림 메시지에서 사용자 지정 오디오를 지원해 왔습니다. 그렇지만 Desktop은 버전 1511(빌드 10586)에서 사용자 지정 오디오 지원만을 추가했습니다. 버전 1511 이전의 Desktop 디바이스에 사용자 지정 오디오를 포함한 알림을 보내면 이 알림은 무음으로 전달됩니다. 따라서 버전 1511 이전 Desktop의 경우에는 알림이 최소한 기본 알림 사운드를 사용할 것이므로 알림 메시지에 사용자 지정 오디오를 포함해서는 안 됩니다.

알려진 문제: Desktop 버전 1511을 사용하는 경우 Microsoft Store를 통해 앱을 설치할 때에만 사용자 지정 메시지 오디오가 작동합니다. 즉, Microsoft Store에 제출하기 전에 Desktop에서 사용자 정의 오디오를 로컬에서 테스트할 수 없지만 일단 Microsoft Store에서 설치하고 나면 오디오가 제대로 작동합니다. Anniversary Update에서 이 문제를 해결했으므로 로컬에 배포된 앱의 사용자 지정 오디오는 올바르게 작동합니다.

var contentBuilder = new ToastContentBuilder()
    .AddText("New message");

    
bool supportsCustomAudio = true;
 
// If we're running on Desktop before Version 1511, do NOT include custom audio
// since it was not supported until Version 1511, and would result in a silent toast.
if (AnalyticsInfo.VersionInfo.DeviceFamily.Equals("Windows.Desktop")
    && !ApiInformation.IsApiContractPresent("Windows.Foundation.UniversalApiContract", 2))
{
    supportsCustomAudio = false;
}
 
if (supportsCustomAudio)
{
    contentBuilder.AddAudio(new Uri("ms-appx:///Assets/Audio/CustomToastAudio.m4a"));
}

// Send the toast
contentBuilder.Show();

다음 오디오 파일 형식을 지원합니다.

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

지원되는 오디오 파일 원본:

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

지원되지 않는 오디오 파일 원본:

  • ms-appdata
  • http://, https://
  • C:/, F:/ 등

알림 보내기

오디오를 사용하여 알림을 보내는 것은 일반 알림을 보내는 것과 같습니다(Show 메서드 호출). 자세한 내용은 로컬 알림 보내기를 참조하세요.