Partilhar via

Áudio personalizado nas notificações do aplicativo

As notificações de aplicativos 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 nas notificações do 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érico.

Instalar o pacote NuGet do Kit de Ferramentas da Comunidade UWP

Para criar notificações via 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 proprietária das notificações na Microsoft.

Instale Microsoft.Toolkit.Uwp.Notifications 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 Toast. No entanto, o Desktop só adicionou suporte para áudio personalizado na versão 1511 (build 10586). Se enviar um Toast que contenha áudio personalizado para um computador de secretária anterior à versão 1511, o toast ficará silencioso. Portanto, para Desktop pré-versão 1511, NÃO se deve incluir o áudio personalizado na notificação toast, para que a notificação use pelo menos o som de notificação padrão.

Problema conhecido: Se estiver a utilizar a Versão Desktop 1511, o áudio personalizado de notificação só funcionará se a sua aplicação estiver instalada através da Microsoft Store. Isso significa que você não pode testar localmente seu áudio personalizado na área de trabalho antes de enviar para a Loja - mas o áudio funcionará bem uma vez instalado a partir da 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 ficheiros de áudio suportados incluem:

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

Fontes de arquivos de áudio suportados:

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

Não há suporte para as fontes de arquivos de áudio:

  • 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 Enviar notificação local para saber mais.

  • Last updated on