Partager via

AppNotificationBuilder.SetAudioUri Méthode

  • Référence

Définition

Espace de noms:
Microsoft.Windows.AppNotifications.Builder

Surcharges

SetAudioUri(Uri)

Définit le fichier audio lu lorsqu’une notification d’application s’affiche.
SetAudioUri(Uri, AppNotificationAudioLooping)

Définit le fichier audio et le comportement de boucle audio qui est lu lorsqu’une notification d’application s’affiche.

SetAudioUri(Uri)

Modifier

Définit le fichier audio lu lorsqu’une notification d’application s’affiche.

public:
 virtual AppNotificationBuilder ^ SetAudioUri(Uri ^ audioUri) = SetAudioUri;
/// [Windows.Foundation.Metadata.Overload("SetAudioUri")]
AppNotificationBuilder SetAudioUri(Uri const& audioUri);
[Windows.Foundation.Metadata.Overload("SetAudioUri")]
public AppNotificationBuilder SetAudioUri(System.Uri audioUri);
function setAudioUri(audioUri)
Public Function SetAudioUri (audioUri As Uri) As AppNotificationBuilder

Paramètres

audioUri
Uri Uri

URI du fichier audio.

Retours

AppNotificationBuilder

Retourne le instance AppNotificationBuilder afin que des appels de méthode supplémentaires puissent être chaînés.

Attributs
OverloadAttribute

Exemples

L’exemple suivant illustre la définition d’un URI audio dans la charge utile XML pour une notification d’application.

var notification = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetAudioUri(new Uri("ms-appx:///Audio/NotificationSound.mp3"))
    .BuildNotification();


AppNotificationManager.Default.Show(notification);

Charge utile XML résultante :

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Notification text.</text>
        </binding>
    </visual>
    <audio src='ms-appx:///Audio/NotificationSound.mp3'/>
</toast>

Remarques

Les types de fichiers audio suivants sont pris en charge :

  • .aac
  • .Flac
  • .m4a
  • .mp3
  • .wav
  • .wma

Les sources de fichiers audio suivantes sont prises en charge :

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

Les sources de fichiers audio suivantes ne sont pas prises en charge :

  • ms-appdata
  • URL Internet, telles que http://, https://
  • Chemins de fichier absolus, tels que C:/, F:/, etc.

Vous pouvez spécifier un événement sonore, qui lit un son défini par le système, en appelant SetAudioEvent.

Pour obtenir des conseils sur l’utilisation des API AppNotificationBuilder pour créer l’interface utilisateur pour les notifications d’application, consultez Contenu des notifications d’application.

Pour obtenir des informations de référence sur le schéma XML pour les notifications d’application, consultez Schéma de contenu de notification d’application.

S’applique à

SetAudioUri(Uri, AppNotificationAudioLooping)

Modifier

Définit le fichier audio et le comportement de boucle audio qui est lu lorsqu’une notification d’application s’affiche.

public:
 virtual AppNotificationBuilder ^ SetAudioUri(Uri ^ audioUri, AppNotificationAudioLooping loop) = SetAudioUri;
/// [Windows.Foundation.Metadata.Overload("SetAudioUri2")]
AppNotificationBuilder SetAudioUri(Uri const& audioUri, AppNotificationAudioLooping const& loop);
[Windows.Foundation.Metadata.Overload("SetAudioUri2")]
public AppNotificationBuilder SetAudioUri(System.Uri audioUri, AppNotificationAudioLooping loop);
function setAudioUri(audioUri, loop)
Public Function SetAudioUri (audioUri As Uri, loop As AppNotificationAudioLooping) As AppNotificationBuilder

Paramètres

audioUri
Uri Uri

URI du fichier audio.

loop
AppNotificationAudioLooping

Membre de l’énumération AppNotificationAudioLooping spécifiant le comportement de boucle pour l’audio.

Retours

AppNotificationBuilder

Retourne le instance AppNotificationBuilder afin que des appels de méthode supplémentaires puissent être chaînés.

Attributs
OverloadAttribute

Exemples

L’exemple suivant illustre la définition d’un URI audio dans la charge utile XML pour une notification d’application.

var notification = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetAudioUri(new Uri("ms-appx:///Audio/NotificationSound.mp3"), AppNotificationAudioLooping.Loop)
    .BuildNotification();


AppNotificationManager.Default.Show(notification);

Charge utile XML résultante :

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Notification text.</text>
        </binding>
    </visual>
    <audio src='ms-appx:///Audio/NotificationSound.mp3'/>
</toast>

Remarques

Les types de fichiers audio suivants sont pris en charge :

  • .aac
  • .Flac
  • .m4a
  • .mp3
  • .wav
  • .wma

Les sources de fichiers audio suivantes sont prises en charge :

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

Les sources de fichiers audio suivantes ne sont pas prises en charge :

  • ms-appdata
  • URL Internet, telles que http://, https://
  • Chemins de fichier absolus, tels que C:/, F:/, etc.

Vous pouvez spécifier un événement sonore, qui lit un son défini par le système, en appelant SetAudioEvent.

Pour obtenir des conseils sur l’utilisation des API AppNotificationBuilder pour créer l’interface utilisateur pour les notifications d’application, consultez Contenu des notifications d’application.

Pour obtenir des informations de référence sur le schéma XML pour les notifications d’application, consultez Schéma de contenu de notification d’application.

S’applique à