AppNotificationBuilder.SetAudioUri Método

Definición

Espacio de nombres:

Microsoft.Windows.AppNotifications.Builder

Sobrecargas

SetAudioUri(Uri)	Establece el archivo de sonido que se reproduce cuando se muestra una notificación de aplicación.
SetAudioUri(Uri, AppNotificationAudioLooping)	Establece el archivo de sonido y el comportamiento de bucle de audio que se reproduce cuando se muestra una notificación de aplicación.

SetAudioUri(Uri)

Establece el archivo de sonido que se reproduce cuando se muestra una notificación de aplicación.

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

Parámetros

audioUri

Uri Uri

URI del archivo de 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 URI de audio en la carga XML para una notificación de aplicación.

var notification = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetAudioUri(new Uri("ms-appx:///Audio/NotificationSound.mp3"))
    .BuildNotification();


AppNotificationManager.Default.Show(notification);

La carga XML resultante:

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Notification text.</text>
        </binding>
    </visual>
    <audio src='ms-appx:///Audio/NotificationSound.mp3'/>
</toast>

Comentarios

Se admiten los siguientes tipos de archivo de audio:

• .aac
• .Flac
• .m4a
• .mp3
• .wav
• .wma

Se admiten los siguientes orígenes de archivos de audio:

• ms-appx:///
• ms-resource

No se admiten los siguientes orígenes de archivos de audio:

• ms-appdata
• Direcciones URL de Internet, como http://, https://
• Rutas de acceso de archivo absolutas, como C:/, F:/, etc.

Puede especificar un evento de sonido, que reproduce un sonido definido por el sistema, llamando a SetAudioEvent.

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.

SetAudioUri(Uri, AppNotificationAudioLooping)

Establece el archivo de sonido y el comportamiento de bucle de audio que se reproduce cuando se muestra una notificación de aplicación.

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

Parámetros

audioUri

Uri Uri

URI del archivo de audio.

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 URI de audio en la carga XML para una notificación de aplicación.

var notification = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetAudioUri(new Uri("ms-appx:///Audio/NotificationSound.mp3"), 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-appx:///Audio/NotificationSound.mp3'/>
</toast>

Comentarios

Se admiten los siguientes tipos de archivo de audio:

• .aac
• .Flac
• .m4a
• .mp3
• .wav
• .wma

Se admiten los siguientes orígenes de archivos de audio:

• ms-appx:///
• ms-resource

No se admiten los siguientes orígenes de archivos de audio:

• ms-appdata
• Direcciones URL de Internet, como http://, https://
• Rutas de acceso de archivo absolutas, como C:/, F:/, etc.

Puede especificar un evento de sonido, que reproduce un sonido definido por el sistema, llamando a SetAudioEvent.

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.