O catálogo de opções de áudio de notificações do sistema (aplicativos da Windows Store)

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 requer sua atenção. 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.

Quando um desses sons é especificado no elemento audio da carga 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 do sistema relacionados neste tópico podem ser usados em uma notificação do sistema; as seleções são extensíveis.

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.

  • 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:
© 2014 Microsoft. Todos os direitos reservados.