AppNotificationBuilder.SetAudioEvent Метод

Определение

Пространство имен:

Microsoft.Windows.AppNotifications.Builder

Перегрузки

SetAudioEvent(AppNotificationSoundEvent)	Задает звуковое событие для уведомления приложения.
SetAudioEvent(AppNotificationSoundEvent, AppNotificationAudioLooping)	Задает поведение звуковых событий и циклов для уведомления приложения.

SetAudioEvent(AppNotificationSoundEvent)

Задает звуковое событие для уведомления приложения.

public:
 virtual AppNotificationBuilder ^ SetAudioEvent(AppNotificationSoundEvent appNotificationSoundEvent) = SetAudioEvent;

/// [Windows.Foundation.Metadata.Overload("SetAudioEvent")]
AppNotificationBuilder SetAudioEvent(AppNotificationSoundEvent const& appNotificationSoundEvent);

[Windows.Foundation.Metadata.Overload("SetAudioEvent")]
public AppNotificationBuilder SetAudioEvent(AppNotificationSoundEvent appNotificationSoundEvent);

function setAudioEvent(appNotificationSoundEvent)

Public Function SetAudioEvent (appNotificationSoundEvent As AppNotificationSoundEvent) As AppNotificationBuilder

Параметры

appNotificationSoundEvent

AppNotificationSoundEvent

Член перечисления AppNotificationSoundEvent , указывающий системный звук для воспроизведения.

Возвращаемое значение

AppNotificationBuilder

Возвращает экземпляр AppNotificationBuilder , чтобы можно было связать в цепочку дополнительные вызовы методов.

Атрибуты

OverloadAttribute

Примеры

В следующем примере показано задание звукового события в полезных данных XML для уведомления приложения.

var notification = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetAudioEvent(AppNotificationSoundEvent.Alarm)
    .BuildNotification();

AppNotificationManager.Default.Show(notification);

Результирующие полезные данные XML:

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Notification text.</text>
        </binding>
    </visual>
    <audio src='ms-winsoundevent:Notification.Looping.Alarm'/>
</toast>

Комментарии

Этот метод позволяет обеспечить согласованное взаимодействие с звуком, указав тип звукового события, который использует стандартизированные системные звуки. Вы можете указать пользовательский звук для уведомления приложения, вызвав SetAudioUri.

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

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

SetAudioEvent(AppNotificationSoundEvent, AppNotificationAudioLooping)

Задает поведение звуковых событий и циклов для уведомления приложения.

public:
 virtual AppNotificationBuilder ^ SetAudioEvent(AppNotificationSoundEvent appNotificationSoundEvent, AppNotificationAudioLooping loop) = SetAudioEvent;

/// [Windows.Foundation.Metadata.Overload("SetAudioEvent2")]
AppNotificationBuilder SetAudioEvent(AppNotificationSoundEvent const& appNotificationSoundEvent, AppNotificationAudioLooping const& loop);

[Windows.Foundation.Metadata.Overload("SetAudioEvent2")]
public AppNotificationBuilder SetAudioEvent(AppNotificationSoundEvent appNotificationSoundEvent, AppNotificationAudioLooping loop);

function setAudioEvent(appNotificationSoundEvent, loop)

Public Function SetAudioEvent (appNotificationSoundEvent As AppNotificationSoundEvent, loop As AppNotificationAudioLooping) As AppNotificationBuilder

Параметры

appNotificationSoundEvent

AppNotificationSoundEvent

Член перечисления AppNotificationSoundEvent , указывающий системный звук для воспроизведения.

loop

AppNotificationAudioLooping

Член перечисления AppNotificationAudioLooping, задающий поведение цикла для звука.

Возвращаемое значение

AppNotificationBuilder

Возвращает экземпляр AppNotificationBuilder , чтобы можно было связать в цепочку дополнительные вызовы методов.

Атрибуты

OverloadAttribute

Примеры

В следующем примере показано задание звукового события в полезных данных XML для уведомления приложения.

var notification = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetAudioEvent(AppNotificationSoundEvent.Alarm, AppNotificationAudioLooping.Loop)
    .BuildNotification();

AppNotificationManager.Default.Show(notification);

Результирующие полезные данные XML:

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Notification text.</text>
        </binding>
    </visual>
    <audio src='ms-winsoundevent:Notification.Looping.Alarm' loop='true'/>
</toast>

Комментарии

Этот метод позволяет обеспечить согласованное взаимодействие с звуком, указав тип звукового события, который использует стандартизированные системные звуки. Вы можете указать пользовательский звук для уведомления приложения, вызвав SetAudioUri.

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

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