Dela via

Anpassat ljud i appaviseringar

Appaviseringar kan använda anpassat ljud, vilket gör att din app kan uttrycka ditt varumärkes unika ljudeffekter. En meddelandeapp kan till exempel använda sitt eget meddelandeljud i sina appaviseringar, så att användaren omedelbart kan veta att de har fått ett meddelande från appen i stället för att höra det allmänna meddelandeljudet.

Installera UWP Community Toolkit NuGet-paketet

För att skapa meddelanden via kod rekommenderar vi starkt att du använder UWP Community Toolkit Notifications-biblioteket, som tillhandahåller en objektmodell för XML-meddelandets innehåll. Du kan manuellt konstruera xml-meddelandet, men det är felbenäget och rörigt. Meddelandebiblioteket i UWP Community Toolkit skapas och underhålls av teamet som äger meddelanden på Microsoft.

Installera Microsoft.Toolkit.Uwp.Notifications från NuGet.

Lägga till namnområdesdeklarationer

using Microsoft.Toolkit.Uwp.Notifications;

Lägg till det anpassade ljudet

Windows Mobile har alltid stöttat anpassat ljud i Toast-aviseringar. Desktop har dock bara lagt till stöd för anpassat ljud i version 1511 (version 10586). Om du skickar en toastnotifikation som innehåller anpassat ljud till en skrivbordsenhet före version 1511 kommer toastnotifikationen att vara tyst. Därför bör du för skrivbordsversioner före 1511 INTE inkludera anpassat ljud i popup-meddelandet, så att meddelandet åtminstone använder standardljudet för meddelanden.

Kända problem: Om du använder skrivbordsversion 1511 fungerar det anpassade popup-ljudet endast om appen installeras via Store. Det innebär att du inte kan testa ditt anpassade ljud lokalt på Desktop innan du skickar till Store – men ljudet fungerar bra när det har installerats från Store. Vi har åtgärdat detta i Anniversary Update, så att anpassat ljud från din lokalt distribuerade app fungerar korrekt.

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

Ljudfiltyper som stöds är:

  • .aac
  • .flac
  • .m4a
  • .mp3
  • .wav
  • .wma

Ljudfilkällor som stöds:

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

Ljudfilkällor som inte stöds:

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

Skicka meddelandet

Att skicka ett meddelande med ljud är detsamma som att skicka ett vanligt meddelande (anropa bara metoden Visa). Mer information finns i Skicka lokalt toastmeddelande för att lära dig mer.