Share via

Audio personalizado en notificaciones del sistema

  • Artículo

Las notificaciones del sistema pueden usar audio personalizado, lo que permite a tu aplicación expresar los efectos de sonido únicos de tu marca. Por ejemplo, una aplicación de mensajería puede usar su propio sonido de mensajería en sus notificaciones del sistema, para que el usuario pueda saber al instante que recibió una notificación de la aplicación, en lugar de escuchar el sonido de notificación genérico.

Instalación del paquete NuGet de UWP Community Toolkit

Para crear notificaciones a través del código, te recomendamos encarecidamente usar la biblioteca de notificaciones del Kit de herramientas de la comunidad para UWP, que proporciona un modelo de objetos para el contenido XML de notificación. Puede construir manualmente el XML de notificación, pero eso es propenso a errores y desordenado. La biblioteca de notificaciones dentro del Kit de herramientas de la comunidad para UWP se crea y mantiene por el equipo que posee notificaciones en Microsoft.

Instale Microsoft.Toolkit.Uwp.Notifications desde NuGet.

Incorporación de declaraciones de espacio de nombres

using Microsoft.Toolkit.Uwp.Notifications;

Adición del audio personalizado

Windows Mobile siempre ha admitido el audio personalizado en las notificaciones del sistema. Sin embargo, Desktop solo agregó compatibilidad con audio personalizado en la versión 1511 (compilación 10586). Si envía una notificación del sistema que contiene audio personalizado a un dispositivo de escritorio antes de la versión 1511, la notificación del sistema será silenciosa. Por lo tanto, para desktop anterior a la versión 1511, no debe incluir el audio personalizado en la notificación del sistema, por lo que la notificación usará al menos el sonido de notificación predeterminado.

Problema conocido: si usas la versión de escritorio 1511, el audio del sistema personalizado solo funcionará si la aplicación está instalada a través de la Tienda. Esto significa que no puedes probar localmente tu audio personalizado en Escritorio antes de enviar a la Tienda, pero el audio funcionará correctamente una vez instalado desde la Tienda. Se ha corregido esto en la actualización de aniversario, por lo que el audio personalizado de la aplicación implementada localmente funcionará correctamente.

var contentBuilder = new ToastContentBuilder()
    .AddText("New message");

    
bool supportsCustomAudio = true;
 
// If we're running on Desktop before Version 1511, do NOT include custom audio
// since it was not supported until Version 1511, and would result in a silent toast.
if (AnalyticsInfo.VersionInfo.DeviceFamily.Equals("Windows.Desktop")
    && !ApiInformation.IsApiContractPresent("Windows.Foundation.UniversalApiContract", 2))
{
    supportsCustomAudio = false;
}
 
if (supportsCustomAudio)
{
    contentBuilder.AddAudio(new Uri("ms-appx:///Assets/Audio/CustomToastAudio.m4a"));
}

// Send the toast
contentBuilder.Show();

Entre los tipos de archivo de audio admitidos se incluyen:

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

Orígenes de archivos de audio admitidos:

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

Orígenes de archivos de audio no admitidos:

  • ms-appdata
  • http://, https://
  • C:/, F:/, etc.

Enviar la notificación

El envío de una notificación con audio es el mismo que el envío de una notificación normal (simplemente llame al método Show). Consulte Envío de notificaciones del sistema local para obtener más información.