Compartilhar via

Áudio personalizado em notificações do aplicativo

As notificações de aplicativo podem usar áudio personalizado, o que permite que seu aplicativo expresse os efeitos sonoros exclusivos da sua marca. Por exemplo, um aplicativo de mensagens pode usar seu próprio som de mensagens em suas notificações de aplicativo, para que o usuário possa saber instantaneamente que recebeu uma notificação do aplicativo, em vez de ouvir o som de notificação genérica.

Instalar o pacote NuGet do Kit de Ferramentas da Comunidade UWP

Para criar notificações por meio 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 o conteúdo XML de notificação. Você pode construir manualmente o XML de notificação, mas isso é propenso a erros e confuso. A biblioteca de notificações dentro do Kit de Ferramentas da Comunidade UWP é criada e mantida pela equipe que possui notificações na Microsoft.

Instale Microsoft.Toolkit.Uwp.Notifications a partir do NuGet.

Adicionar declarações de namespace

using Microsoft.Toolkit.Uwp.Notifications;

Adicionar o áudio personalizado

O Windows Mobile sempre deu suporte a áudio personalizado em notificações do Toast. No entanto, o aplicativo Desktop só adicionou suporte para áudio customizado na versão 1511 (build 10586). Se você enviar um Toast que contenha áudio personalizado para um dispositivo desktop antes da versão 1511, o Toast ficará silencioso. Portanto, para a versão do Desktop anterior à 1511, você NÃO deve incluir o áudio personalizado na notificação de Toast, para que a notificação ao menos use o som de notificação padrão.

Problema conhecido: se você estiver usando a versão para desktop 1511, o áudio de notificação personalizado só funcionará se o aplicativo estiver instalado por meio da Microsoft Store. Isso significa que você não pode testar localmente o áudio personalizado na Área de Trabalho antes de enviar para a Loja, mas o áudio funcionará bem depois de instalado na Loja. 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

Não fontes de arquivo de áudio com 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). Veja o envio local de notificação para saber mais.

  • Last updated on