AppNotificationBuilder.SetAudioEvent Método

Definição

Namespace:

Microsoft.Windows.AppNotifications.Builder

Sobrecargas

SetAudioEvent(AppNotificationSoundEvent)	Define o evento de áudio para uma notificação do aplicativo.
SetAudioEvent(AppNotificationSoundEvent, AppNotificationAudioLooping)	Define o evento de áudio e o comportamento de loop para uma notificação do aplicativo.

SetAudioEvent(AppNotificationSoundEvent)

Define o evento de áudio para uma notificação do aplicativo.

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

Parâmetros

appNotificationSoundEvent

AppNotificationSoundEvent

Um membro da enumeração AppNotificationSoundEvent especificando um som do sistema a ser reproduzido.

Retornos

AppNotificationBuilder

Retorna a instância AppNotificationBuilder para que chamadas de método adicionais possam ser encadeadas.

Atributos

OverloadAttribute

Exemplos

O exemplo a seguir demonstra a configuração de um evento de áudio no conteúdo XML para uma notificação de aplicativo.

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

AppNotificationManager.Default.Show(notification);

O conteúdo XML resultante:

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

Comentários

Esse método permite que você forneça uma experiência de áudio consistente especificando um tipo de evento de áudio, que usa sons padronizados do sistema. Você pode especificar um som personalizado para uma notificação de aplicativo chamando SetAudioUri.

Para obter diretrizes sobre como usar as APIs AppNotificationBuilder para criar a interface do usuário para notificações de aplicativo, consulte conteúdo de notificação do aplicativo.

Para obter informações de referência sobre o esquema XML para notificações de aplicativo, consulte esquema de conteúdo de notificação do aplicativo.

SetAudioEvent(AppNotificationSoundEvent, AppNotificationAudioLooping)

Define o evento de áudio e o comportamento de loop para uma notificação do aplicativo.

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

Parâmetros

appNotificationSoundEvent

AppNotificationSoundEvent

Um membro da enumeração AppNotificationSoundEvent especificando um som do sistema a ser reproduzido.

loop

AppNotificationAudioLooping

Um membro da enumeração AppNotificationAudioLooping especificando o comportamento de looping para o áudio.

Retornos

AppNotificationBuilder

Retorna a instância AppNotificationBuilder para que chamadas de método adicionais possam ser encadeadas.

Atributos

OverloadAttribute

Exemplos

O exemplo a seguir demonstra a configuração de um evento de áudio no conteúdo XML para uma notificação de aplicativo.

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

AppNotificationManager.Default.Show(notification);

O conteúdo XML resultante:

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

Comentários

Esse método permite que você forneça uma experiência de áudio consistente especificando um tipo de evento de áudio, que usa sons padronizados do sistema. Você pode especificar um som personalizado para uma notificação de aplicativo chamando SetAudioUri.

Para obter diretrizes sobre como usar as APIs AppNotificationBuilder para criar a interface do usuário para notificações de aplicativo, consulte conteúdo de notificação do aplicativo.

Para obter informações de referência sobre o esquema XML para notificações de aplicativo, consulte esquema de conteúdo de notificação do aplicativo.