Benutzerdefinierte Audiodaten für Popups

  • Artikel

Popupbenachrichtigungen können benutzerdefinierte Audiodaten verwenden, mit denen Ihre App die einzigartigen Soundeffekte Ihrer Marke ausdrücken kann. Beispielsweise kann eine Messaging-App ihren eigenen Messagingsound für ihre Popupbenachrichtigungen verwenden, sodass der Benutzer sofort wissen kann, dass er eine Benachrichtigung von der App erhalten hat, anstatt den generischen Benachrichtigungssound zu hören.

Installieren des NuGet-Pakets für das UWP Community Toolkit

Um Benachrichtigungen über Code zu erstellen, empfehlen wir dringend die Verwendung der UWP Community Toolkit Notifications Library, die ein Objektmodell für den Benachrichtigungs-XML-Inhalt bereitstellt. Sie könnten die Benachrichtigungs-XML manuell erstellen, aber das ist fehleranfällig und unordentlich. Die Benachrichtigungsbibliothek im UWP Community Toolkit wird von dem Team erstellt und verwaltet, das Benachrichtigungen bei Microsoft besitzt.

Installieren Sie Microsoft.Toolkit.Uwp.Notifications über NuGet.

Hinzufügen von Namespace-Deklarationen

using Microsoft.Toolkit.Uwp.Notifications;

Hinzufügen des benutzerdefinierten Audios

Windows Mobile unterstützt seit jeher benutzerdefinierte Audiodaten in Popupbenachrichtigungen. Desktop hat jedoch nur in Version 1511 (Build 10586) Unterstützung für benutzerdefiniertes Audio hinzugefügt. Wenn Sie ein Popup senden, das benutzerdefinierte Audiodaten vor Version 1511 an ein Desktopgerät enthält, wird das Popup im Hintergrund angezeigt. Daher sollten Sie für Desktop vor Version 1511 die benutzerdefinierte Audiowiedergabe NICHT in Die Popupbenachrichtigung einschließen, damit die Benachrichtigung mindestens den Standardbenachrichtigungssound verwendet.

Bekanntes Problem: Wenn Sie Desktopversion 1511 verwenden, funktioniert das benutzerdefinierte Popupaudio nur, wenn Ihre App über den Store installiert wird. Dies bedeutet, dass Sie Ihr benutzerdefiniertes Audio nicht lokal auf dem Desktop testen können, bevor sie an den Store übermittelt werden. Die Audiodaten funktionieren jedoch nach der Installation aus dem Store einwandfrei. Dies wurde im Anniversary Update behoben, sodass benutzerdefinierte Audiodaten aus Ihrer lokal bereitgestellten App ordnungsgemäß funktionieren.

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

Zu den unterstützten Audiodateitypen gehören:

  • .aac
  • .Flac
  • .m4a
  • .mp3
  • WAV
  • .wma

Unterstützte Audiodateiquellen:

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

Nicht unterstützte Audiodateiquellen:

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

Senden der Benachrichtigung

Das Senden einer Benachrichtigung mit Audio ist identisch mit dem Senden einer regulären Benachrichtigung (rufen Sie einfach die Show-Methode auf). Weitere Informationen finden Sie unter Senden eines lokalen Popups .