Audio personnalisé sur les toasts

  • Article

Les notifications toast peuvent utiliser un audio personnalisé, ce qui permet à votre application d’exprimer les effets sonores uniques de votre marque. Par exemple, une application de messagerie peut utiliser son propre son de messagerie sur ses notifications Toast, afin que l’utilisateur puisse savoir instantanément qu’il a reçu une notification de l’application, au lieu d’entendre le son de notification générique.

Installer le package NuGet du kit de ressources de la communauté UWP

Pour créer des notifications via du code, nous vous recommandons vivement d’utiliser la bibliothèque de notifications du kit de ressources de la communauté UWP, qui fournit un modèle objet pour le contenu XML de notification. Vous pouvez construire manuellement le code XML de notification, mais il est sujet aux erreurs et désordonné. La bibliothèque notifications dans UWP Community Toolkit est créée et gérée par l’équipe propriétaire des notifications chez Microsoft.

Installez Microsoft.Toolkit.Uwp.Notifications à partir de NuGet.

Ajout de déclarations d'espaces de noms

using Microsoft.Toolkit.Uwp.Notifications;

Ajouter l’audio personnalisé

Windows Mobile a toujours pris en charge l’audio personnalisé dans les notifications Toast. Toutefois, Desktop a ajouté uniquement la prise en charge de l’audio personnalisé dans la version 1511 (build 10586). Si vous envoyez un toast qui contient de l’audio personnalisé à un appareil de bureau avant la version 1511, le toast sera silencieux. Par conséquent, pour desktop pré-version 1511, vous ne devez PAS inclure l’audio personnalisé dans votre notification Toast, afin que la notification utilise au moins le son de notification par défaut.

Problème connu : si vous utilisez desktop version 1511, l’audio toast personnalisé ne fonctionnera que si votre application est installée via le Windows Store. Cela signifie que vous ne pouvez pas tester localement votre audio personnalisé sur le Bureau avant de l’envoyer au Windows Store, mais que l’audio fonctionne correctement une fois installé à partir du Windows Store. Nous avons résolu ce problème dans la mise à jour anniversaire, afin que l’audio personnalisé de votre application déployée localement fonctionne correctement.

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

Les types de fichiers audio pris en charge sont les suivants :

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

Sources de fichiers audio prises en charge :

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

Sources de fichiers audio non prises en charge :

  • ms-appdata
  • http://, https://
  • C:/, F:/, etc.

Envoyer la notification

L’envoi d’une notification avec audio est identique à l’envoi d’une notification régulière (il suffit d’appeler la méthode Show). Pour en savoir plus, consultez Envoyer des toasts locaux .