AppNotificationBuilder.SetAudioEvent Método

Definición

Espacio de nombres:

Microsoft.Windows.AppNotifications.Builder

Sobrecargas

SetAudioEvent(AppNotificationSoundEvent)	Establece el evento de audio para una notificación de aplicación.
SetAudioEvent(AppNotificationSoundEvent, AppNotificationAudioLooping)	Establece el evento de audio y el comportamiento de bucle para una notificación de aplicación.

SetAudioEvent(AppNotificationSoundEvent)

Establece el evento de audio para una notificación de aplicación.

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

Miembro de la enumeración AppNotificationSoundEvent que especifica un sonido del sistema que se va a reproducir.

Devoluciones

AppNotificationBuilder

Devuelve la instancia de AppNotificationBuilder para que se puedan encadenar llamadas de método adicionales.

Atributos

OverloadAttribute

Ejemplos

En el ejemplo siguiente se muestra cómo establecer un evento de audio en la carga XML para una notificación de aplicación.

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

AppNotificationManager.Default.Show(notification);

La carga XML resultante:

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

Comentarios

Este método permite proporcionar una experiencia de audio coherente especificando un tipo de evento de audio, que usa sonidos del sistema estandarizados. Puede especificar un sonido personalizado para una notificación de aplicación llamando a SetAudioUri.

Para obtener instrucciones sobre el uso de las API de AppNotificationBuilder para crear la interfaz de usuario para las notificaciones de la aplicación, consulte Contenido de la notificación de la aplicación.

Para obtener información de referencia sobre el esquema XML para las notificaciones de aplicaciones, consulte Esquema de contenido de notificación de aplicaciones.

SetAudioEvent(AppNotificationSoundEvent, AppNotificationAudioLooping)

Establece el evento de audio y el comportamiento de bucle para una notificación de aplicación.

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

Miembro de la enumeración AppNotificationSoundEvent que especifica un sonido del sistema que se va a reproducir.

loop

AppNotificationAudioLooping

Miembro de la enumeración AppNotificationAudioLooping que especifica el comportamiento de bucle para el audio.

Devoluciones

AppNotificationBuilder

Devuelve la instancia de AppNotificationBuilder para que se puedan encadenar llamadas de método adicionales.

Atributos

OverloadAttribute

Ejemplos

En el ejemplo siguiente se muestra cómo establecer un evento de audio en la carga XML para una notificación de aplicación.

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

AppNotificationManager.Default.Show(notification);

La carga XML resultante:

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

Comentarios

Este método permite proporcionar una experiencia de audio coherente especificando un tipo de evento de audio, que usa sonidos del sistema estandarizados. Puede especificar un sonido personalizado para una notificación de aplicación llamando a SetAudioUri.

Para obtener instrucciones sobre el uso de las API de AppNotificationBuilder para crear la interfaz de usuario para las notificaciones de la aplicación, consulte Contenido de la notificación de la aplicación.

Para obtener información de referencia sobre el esquema XML para las notificaciones de aplicaciones, consulte Esquema de contenido de notificación de aplicaciones.