Поделиться через

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

Примеры

В следующем примере показано, как задать универсальный код ресурса (URI) звука в полезных данных XML для уведомления приложения.

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
  • URL-адреса Интернета, такие как http://, https://
  • Абсолютные пути к файлам, например C:/, F:/и т. д.

Вы можете указать звуковое событие, которое воспроизводит системный звук, вызвав SetAudioEvent.

Инструкции по использованию API AppNotificationBuilder для создания пользовательского интерфейса для уведомлений приложений см. в содержимомуведомлений приложений.

Справочные сведения о схеме 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

Примеры

В следующем примере показано, как задать универсальный код ресурса (URI) звука в полезных данных XML для уведомления приложения.

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
  • URL-адреса Интернета, такие как http://, https://
  • Абсолютные пути к файлам, например C:/, F:/и т. д.

Вы можете указать звуковое событие, которое воспроизводит системный звук, вызвав SetAudioEvent.

Инструкции по использованию API AppNotificationBuilder для создания пользовательского интерфейса для уведомлений приложений см. в содержимомуведомлений приложений.

Справочные сведения о схеме XML для уведомлений приложений см. в схеме содержимого уведомления приложения.

Применяется к