Freigeben über

Benutzerdefiniertes Audio in App-Benachrichtigungen

App-Benachrichtigungen können benutzerdefinierte Audiodaten verwenden, mit denen Ihre App die einzigartigen Soundeffekte Ihrer Marke ausdrücken kann. Beispielsweise kann eine Messaging-App ihren eigenen Messaging-Sound in ihren App-Benachrichtigungen verwenden, damit der Benutzer sofort wissen kann, dass er eine Benachrichtigung von der App empfangen hat, anstatt den generischen Benachrichtigungssound zu hören.

UWP Community Toolkit NuGet-Paket installieren

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

Installieren Sie Microsoft.Toolkit.Uwp.Notifications von NuGet.

Hinzufügen von Namespacedeklarationen

using Microsoft.Toolkit.Uwp.Notifications;

Füge das benutzerdefinierte Audio hinzu

Windows Mobile hat immer benutzerdefinierte Audiodateien in Popupbenachrichtigungen unterstützt. Desktop hat allerdings erst in Version 1511 (Build 10586) Unterstützung für benutzerdefiniertes Audio hinzugefügt. Wenn Sie vor Version 1511 einen Toast mit benutzerdefiniertem Audio an ein Desktopgerät senden, wird der Toast stumm sein. Daher sollten Sie für Desktop-Vorversionen vor 1511 nicht den benutzerdefinierten Ton in Ihre Toast-Benachrichtigung einschließen, damit die Benachrichtigung zumindest den Standardbenachrichtigungston verwendet.

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

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.

Benachrichtigung senden

Das Senden einer Benachrichtigung mit Audio ist identisch mit dem Senden einer regulären Benachrichtigung (rufen Sie einfach die Show-Methode auf). Um mehr zu erfahren, senden Sie die lokale Benachrichtigung .

  • Last updated on