Windows Dev Center

Catalogue d’options audio de toast (applications Windows Runtime)

Cette rubrique répertorie les options audio fournies par Windows qui sont utilisables dans une notification toast. Le son spécifié est lu lorsque la notification s’affiche, indiquant à l’utilisateur qu’un message s’affiche. Ces options audio sont utilisées par les développeurs d’applications lorsqu’ils définissent la charge de travail XML d’une notification toast. Pour plus d’informations, voir Démarrage rapide : envoi d’une notification toast.

Audio de toast sur Windows Phone 8.1

Lorsque vous spécifiez l’un des sons fournis par le système dans l’élément audio de la charge utile XML de la notification toast, vous devez ajouter le préfixe « ms-winsoundevent: ». Par exemple :



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

Remarque  Seuls les sons fournis par le système, répertoriés dans cette rubrique, peuvent être utilisés dans une notification toast Windows ; les sélections ne sont pas extensibles.

Remarque  Windows Phone 8.1 permet l’utilisation d’une ressource audio locale en plus des options audio de toast décrites ici.

Sons à lecture unique

Les sons suivants ne sont émis qu’une fois et ne sont pas répétés. Affectez à l’attribut loop la valeur false.

  • Notification.Default

    Son qui est émis dans les situations suivantes :

    • lorsque cela est spécifié de manière explicite ;
    • lorsqu’aucune autre option audio n’est spécifiée ;
    • lorsque l’option spécifiée n’est pas valide ;
    • lorsqu’aucune autre option n’est adaptée à votre scénario.
  • Notification.IM

    Scénario : une nouvelle notification de messagerie instantanée est arrivée.

  • Notification.Mail

    Scénario : un nouveau courrier électronique est arrivé.

  • Notification.Reminder

    Scénario : un élément de calendrier est arrivé à échéance.

  • Notification.SMS

    Scénario : un nouveau message texte est arrivé.

Sons en boucle

Les sons suivants peuvent être mis en boucle jusqu’à ce qu’une notification soit prise en compte.

Remarque  Le son en boucle nécessite que vous affectiez la valeur « long » à l’attribut duration de l’élément toast parent des éléments audio. Pour plus d’informations, voir la section Remarques.

Remarque  Le son en boucle et les toasts de longue durée ne sont pas pris en charge sur Windows Phone 8.1.

  • Notification.Looping.Alarm

    Scénario : un chronomètre de compte à rebours a atteint 0.

  • Notification.Looping.Alarm2

    Scénario : un chronomètre de compte à rebours a atteint 0.

  • Notification.Looping.Alarm3

    Scénario : un chronomètre de compte à rebours a atteint 0.

  • Notification.Looping.Alarm4

    Scénario : un chronomètre de compte à rebours a atteint 0.

  • Notification.Looping.Alarm5

    Scénario : un chronomètre de compte à rebours a atteint 0.

  • Notification.Looping.Alarm6

    Scénario : un chronomètre de compte à rebours a atteint 0.

  • Notification.Looping.Alarm7

    Scénario : un chronomètre de compte à rebours a atteint 0.

  • Notification.Looping.Alarm8

    Scénario : un chronomètre de compte à rebours a atteint 0.

  • Notification.Looping.Alarm9

    Scénario : un chronomètre de compte à rebours a atteint 0.

  • Notification.Looping.Alarm10

    Scénario : un chronomètre de compte à rebours a atteint 0.

  • Notification.Looping.Call

    Scénario : appel téléphonique entrant.

  • Notification.Looping.Call2

    Scénario : appel téléphonique entrant.

  • Notification.Looping.Call3

    Scénario : appel téléphonique entrant.

  • Notification.Looping.Call4

    Scénario : appel téléphonique entrant.

  • Notification.Looping.Call5

    Scénario : appel téléphonique entrant.

  • Notification.Looping.Call6

    Scénario : appel téléphonique entrant.

  • Notification.Looping.Call7

    Scénario : appel téléphonique entrant.

  • Notification.Looping.Call8

    Scénario : appel téléphonique entrant.

  • Notification.Looping.Call9

    Scénario : appel téléphonique entrant.

  • Notification.Looping.Call10

    Scénario : appel téléphonique entrant.

Si le son en boucle est spécifié dans le modèle de toast mais que la source n’est pas valide ou qu’elle n’est pas indiquée, le son Notification.Looping.Call est utilisé.

Aucun son

Pour envoyer une notification toast qui n’émet aucun son à l’arrivée, vous devez affecter la valeur « true » à l’attribut silent de l’élément audio comme illustré ici. L’élément audio est nécessaire et ne peut pas être simplement omis.



<audio silent="true"/>

Exemples

L’exemple suivant montre comment définir un son pour une notification toast qui informe un utilisateur de l’arrivée d’un message instantané.



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

L’exemple suivant montre comment définir un son pour une notification toast qui indique à un utilisateur un appel entrant.



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

L’exemple suivant montre comment déclarer qu’une notification toast ne doit pas émettre de son.



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

Rubriques associées

audio element
Démarrage rapide : envoi d’une notification toast
Exemple de notifications toast
Schéma XML de toast

 

 

Afficher:
© 2015 Microsoft