Audio personnalisé sur les toasts

  • Article

Les notifications toast peuvent utiliser l’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 instantanément savoir qu’il a reçu une notification de l’application, plutôt que d’entendre le son de notification générique.

Installer le package NuGet du Kit de ressources communautaires UWP

Pour créer des notifications via du code, nous vous recommandons vivement d’utiliser la bibliothèque de notifications du Kit de ressources communautaires UWP, qui fournit un modèle objet pour le contenu XML de notification. Vous pouvez construire manuellement le code XML de notification, mais il s’agit d’une erreur et d’un désordre. La bibliothèque notifications dans UWP Community Toolkit est créée et gérée par l’équipe qui possède 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 uniquement ajouté la prise en charge de l’audio personnalisé dans la version 1511 (build 10586). Si vous envoyez un toast contenant du contenu 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é fonctionne uniquement 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 le soumettre au Windows Store, mais l’audio fonctionne correctement une fois installé à partir du Windows Store. Nous avons résolu cela 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 (appelez simplement la méthode Show). Pour en savoir plus, consultez Envoyer un toast local.