O catálogo de opções de áudio para notificações do sistema
Recolher sumário
Expandir sumário

O catálogo de opções de áudio de notificações do sistema (aplicativos do Tempo de Execução do Windows)

[ Este artigo destina-se aos desenvolvedores do Windows 8.x e do Windows Phone 8.x que escrevem aplicativos do Windows Runtime. Se você estiver desenvolvendo para o Windows 10, consulte documentação mais recente]

Este tópico lista as opções de áudio fornecidas pelo Windows disponíveis para serem usadas em uma notificação do sistema. O som especificado é reproduzido quando a notificação é exibida, como uma indicação para o usuário que uma mensagem está sendo mostrada. Essas opções de áudio são usadas ​​por desenvolvedores de aplicativos quando eles definem a carga XML uma notificação do sistema. Para saber mais, veja Guia de início rápido: enviando uma notificação do sistema.

Áudio de notificação do sistema no Windows Phone 8.1

Quando um desses sons fornecidos pelo sistema é especificado no elemento audio do conteúdo XML da notificação do sistema, é necessário adicionar o prefixo "ms-winsoundevent". Por exemplo:



    <audio src="ms-winsoundevent:Notification.Mail" loop="false"/>

Observação  Somente os sons fornecidos pelo sistema relacionados neste tópico podem ser usados em uma notificação do sistema do Windows; as seleções não são extensíveis.

Observação  O Windows Phone 8.1 permite o uso de um recurso de áudio local, além das opções de áudio de notificação do sistema discutidas aqui.

Sons sem repetição

Os sons a seguir são reproduzidos uma única vez e não se repetem. Defina o atributo loop como false.

  • Notification.Default

    O som que é reproduzido nas seguintes situações:

    • Quando é especificado explicitamente
    • Quando nenhuma outra opção de áudio é especificada
    • Quando a opção de áudio especificada é inválida
    • Quando nenhuma outra opção de áudio é compatível com o seu cenário
  • Notification.IM

    Cenário: uma nova notificação do sistema de mensagens instantâneas foi recebida.

  • Notification.Mail

    Cenário: um novo email foi recebido.

  • Notification.Reminder

    Cenário: há um item de calendário pendente.

  • Notification.SMS

    Cenário: uma nova mensagem de texto foi recebida.

Sons com repetição

Os sons a seguir podem, opcionalmente, ser reproduzidos em loop até que alguma providência seja tomada com relação à notificação.

Observação  Para usar áudio em loop, é necessário definir o atributo duration no elemento pai audio do elemento toast como "long". Para saber mais, veja a seção Comentários.
 

Observação  Não há suporte para áudio em loop e notificações do sistema de longa duração no Windows Phone 8.1.

  • Notification.Looping.Alarm

    Cenário: um cronômetro de contagem regressiva atingiu 0.

  • Notification.Looping.Alarm2

    Cenário: um cronômetro de contagem regressiva atingiu 0.

  • Notification.Looping.Alarm3

    Cenário: um cronômetro de contagem regressiva atingiu 0.

  • Notification.Looping.Alarm4

    Cenário: um cronômetro de contagem regressiva atingiu 0.

  • Notification.Looping.Alarm5

    Cenário: um cronômetro de contagem regressiva atingiu 0.

  • Notification.Looping.Alarm6

    Cenário: um cronômetro de contagem regressiva atingiu 0.

  • Notification.Looping.Alarm7

    Cenário: um cronômetro de contagem regressiva atingiu 0.

  • Notification.Looping.Alarm8

    Cenário: um cronômetro de contagem regressiva atingiu 0.

  • Notification.Looping.Alarm9

    Cenário: um cronômetro de contagem regressiva atingiu 0.

  • Notification.Looping.Alarm10

    Cenário: um cronômetro de contagem regressiva atingiu 0.

  • Notification.Looping.Call

    Cenário: uma chamada telefônica de entrada.

  • Notification.Looping.Call2

    Cenário: uma chamada telefônica de entrada.

  • Notification.Looping.Call3

    Cenário: uma chamada telefônica de entrada.

  • Notification.Looping.Call4

    Cenário: uma chamada telefônica de entrada.

  • Notification.Looping.Call5

    Cenário: uma chamada telefônica de entrada.

  • Notification.Looping.Call6

    Cenário: uma chamada telefônica de entrada.

  • Notification.Looping.Call7

    Cenário: uma chamada telefônica de entrada.

  • Notification.Looping.Call8

    Cenário: uma chamada telefônica de entrada.

  • Notification.Looping.Call9

    Cenário: uma chamada telefônica de entrada.

  • Notification.Looping.Call10

    Cenário: uma chamada telefônica de entrada.

Se o áudio em loop for especificado no modelo de notificação do sistema mas sua origem for inválida ou não especificada, o som Notification.Looping.Call será usado.

Nenhum som

Para enviar uma notificação do sistema que não reproduz nenhum som ao ser recebida, é necessário definir o atributo silent no elemento audio como "true", como mostrado aqui. O elemento de áudio é obrigatório e não pode simplesmente ser omitido.



<audio silent="true"/>

Exemplos

O exemplo a seguir mostra como definir um som para uma notificação do sistema informando ao usuário que uma mensagem instantânea acabou de chegar.



var template = Windows.UI.Notifications.ToastTemplateType.toastImageAndText01;
var toastXml = Windows.UI.Notifications.ToastNotificationManager.getTemplateContent(template);

var toastAudioElements = toastXml.getElementsByTagName("audio");
toastAudioElements[0].setAttribute("src", "ms-winsoundevent:Notification.IM");
toastAudioElements[0].setAttribute("loop", "false");

O exemplo a seguir mostra como definir um som em loop para uma notificação do sistema informando ao usuário sobre uma chamada de entrada.



var template = Windows.UI.Notifications.ToastTemplateType.toastText02
var toastXml = Windows.UI.Notifications.ToastNotificationManager.getTemplateContent(template);                    
var toastNode = toastXml.selectSingleNode("/toast");
toastNode.setAttribute("duration", "long");

var audio = toastXml.createElement("audio");
audio.setAttribute("src", "ms-winsoundevent:Notification.Looping.Call");
audio.setAttribute("loop", "true");

toastNode.appendChild(audio);

O exemplo a seguir mostra como declarar que uma notificação do sistema não deve reproduzir um som.



var template = Windows.UI.Notifications.ToastTemplateType.toastImageAndText01;
var toastXml = Windows.UI.Notifications.ToastNotificationManager.getTemplateContent(template);

var toastAudioElements = toastXml.getElementsByTagName("audio");
toastAudioElements[0].setAttribute("silent", true);

Tópicos relacionados

audio element
Guia de início rápido: Enviando uma notificação do sistema
Exemplo de notificações do sistema
Esquema XML de notificação do sistema

 

 

Mostrar:
© 2017 Microsoft