Áudio personalizado em notificações do sistema

  • Artigo

As notificações do sistema podem usar áudio personalizado, o que permite ao aplicativo expressar os efeitos de som exclusivos da sua marca. Por exemplo, um aplicativo de mensagens pode usar seus próprios sons nas mensagens nas notificações do sistema para que o usuário saiba instantaneamente que eles receberam uma notificação do aplicativo, em vez de ouvir o som de notificação genérico.

Instalar o pacote NuGet do kit de ferramentas da comunidade UWP

Para criar notificações através do código, é altamente recomendável usar a biblioteca de Notificações do kit de ferramentas da comunidade UWP, que fornece um modelo de objeto para a conteúdo XML da notificação. Você pode construir manualmente o XML de notificação, mas isso é propenso a erros e confuso. A biblioteca de notificações no Kit de ferramentas da comunidade UWP é criado e mantido pela equipe especialista em notificações na Microsoft.

Instale o Microsoft.Toolkit.Uwp.Notifications do NuGet.

Adicionar declarações do namespace

using Microsoft.Toolkit.Uwp.Notifications;

Adicionar áudio personalizado

O Windows Mobile sempre ofereceu suporte a áudio personalizado nas notificações do sistema. No entanto, a área de trabalho adicionou somente o suporte para áudio personalizado na Versão 1511 (build 10586). Se você enviar uma notificação do sistema com o áudio personalizados para um dispositivo da área de trabalho antes de versão 1511, a notificação do sistema ficará silenciosa. Portanto, para a versão de pré-lançamento da área de trabalho 1511, você não deve incluir o áudio personalizado em sua notificação do sistema, pois a notificação usará pelo menos o som de notificação padrão.

Problema conhecido: se você estiver usando a área de trabalho versão 1511, o áudio de notificação do sistema personalizado funcionará somente se o aplicativo for instalado pela Store. Isso significa que você não pode testar localmente seu áudio personalizados na área de trabalho antes de enviá-lo para a Store, mas o áudio funcionará quando instalado pela Store. Corrigimos isso na Atualização de Aniversário, para que o áudio personalizado do seu aplicativo implantado localmente funcione corretamente.

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();

Os tipos de arquivo de áudio com suporte incluem:

  • .aac
  • .flac
  • .m4a
  • .mp3
  • .wav
  • .wma

Fontes de arquivo de áudio com suporte:

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

Fontes de arquivo de áudio sem suporte:

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

Enviar a notificação

Enviar uma notificação com áudio é o mesmo que enviar uma notificação regular (basta chamar o método Show). Confira Enviar notificação do sistema local para saber mais.