Настраиваемый звук всплывающих уведомлениях

  • Статья

Всплывающие уведомления могут использовать настраиваемый звук, что позволяет приложению воспроизводить уникальные звуковые эффекты. Например, приложение для обмена сообщениями может собственные звуки сообщений для своих всплывающих уведомлений, чтобы пользователи могли сразу понять, что они получили уведомление от вашего приложения.

Установка пакета набора средств сообщества UWP из NuGet

Для создания уведомлений в коде мы настоятельно рекомендуем использовать библиотеку уведомлений набора средств сообщества UWP, которая предоставляет объектную модель для XML-содержимого уведомлений. Вы можете вручную создать XML-содержимое уведомления, но это сложно и может привести к ошибкам. Библиотеку уведомлений в наборе средств сообщества UWP создала и поддерживает команда, которая отвечает за уведомления в корпорации Майкрософт.

Установите Microsoft.Toolkit.Uwp.Notifications из NuGet.

Добавление объявлений пространств имен

using Microsoft.Toolkit.Uwp.Notifications;

Добавление настраиваемых аудиозаписи

ОС Windows Mobile всегда поддерживала настраиваемый звук для всплывающих уведомлений. Однако в ОС для настольных компьютеров поддержка настраиваемых звуков была реализована только в версии 1511 (сборка 10586). При отправке всплывающего уведомления, содержащего настраиваемый звук, на настольный компьютер с версией ОС до 1511, звук всплывающего уведомления не воспроизводится. Поэтому для настольных компьютеров с ОС версией до 1511 вам не следует включать настраиваемый звук для всплывающего уведомления, чтобы уведомление использовало по крайней мере звуковой сигнал по умолчанию.

Известная проблема: если вы используете ОС для настольного компьютера версии 1511, настраиваемый звук всплывающего уведомления будет работать, только если приложение установлено через Store. Это означает, что вы не сможете локально протестировать настраиваемый звук до отправки приложения в Store, но звук будет работать после установки из Store. Мы исправили это в юбилейном обновлении, чтобы настраиваемый звук из локально развернутого приложения работал правильно.

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). Дополнительные сведения см. в разделе Отправка локального всплывающего уведомления .