Compartir a través de

Audio personalizado en las notificaciones de la aplicación

Las notificaciones de la aplicación pueden usar audio personalizado, lo que permite a la aplicación expresar los efectos de sonido únicos de la marca. Por ejemplo, una aplicación de mensajería puede usar su propio sonido de mensajería en sus notificaciones de aplicación, de modo 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 es propenso a errores y desordenado. La biblioteca de notificaciones dentro del Kit de herramientas para la comunidad de UWP se crea y mantiene por el equipo que posee notificaciones en Microsoft.

Instale Microsoft.Toolkit.Uwp.Notifications desde NuGet.

Añadir declaraciones de espacio de nombres

using Microsoft.Toolkit.Uwp.Notifications;

Adición del audio personalizado

Windows Mobile siempre ha admitido 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 un toast que contiene audio personalizado a un dispositivo de escritorio que ejecuta una versión anterior a la 1511, el toast no emitirá sonido. Por lo tanto, para escritorios con versiones anteriores a la 1511, no debe incluir el audio personalizado en la notificación Toast, de modo que la notificación use al menos el sonido predeterminado.

Problema Conocido: Si usas la Versión de Escritorio 1511, el audio de notificación personalizado solo funcionará si tu aplicación está instalada a través de la Microsoft Store. Esto significa que no puedes probar localmente tu audio personalizado en Escritorio antes de enviarlo a la Tienda, pero el audio funcionará correctamente una vez instalado desde la Tienda. Hemos corregido esto en la actualización de aniversario, de modo 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

No hay fuentes de archivos de audio admitidas:

  • 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 enviar una notificación local para obtener más información.

  • Last updated on