Delen via

Aangepaste audio in app-meldingen

App-meldingen kunnen gebruikmaken van aangepaste audio, zodat uw app de unieke geluidseffecten van uw merk kan uitdrukken. Een berichten-app kan bijvoorbeeld hun eigen berichtgeluid gebruiken in de app-meldingen, zodat de gebruiker direct weet dat hij of zij een melding van de app heeft ontvangen, in plaats van het algemene meldingsgeluid te horen.

UWP Community Toolkit NuGet-pakket installeren

Als u meldingen via code wilt maken, raden we u ten zeerste aan de BIBLIOTHEEK MET MELDINGEN van de UWP Community Toolkit te gebruiken, die een objectmodel biedt voor de XML-inhoud voor meldingen. U kunt de meldings-XML handmatig samenstellen, maar dat is foutgevoelig en rommelig. De meldingenbibliotheek in UWP Community Toolkit wordt gebouwd en onderhouden door het team dat eigenaar is van meldingen bij Microsoft.

Installeer Microsoft.Toolkit.Uwp.Notifications vanuit NuGet.

Naamruimtedeclaraties toevoegen

using Microsoft.Toolkit.Uwp.Notifications;

Aangepaste audio toevoegen

Windows Mobile biedt altijd ondersteuning voor aangepaste audio in toastmeldingen. Desktop heeft echter alleen ondersteuning toegevoegd voor aangepaste audio in versie 1511 (build 10586). Als u vóór versie 1511 een toast-bericht met aangepaste audio naar een desktopapparaat verzendt, zal de toast stil zijn. Daarom moet u voor oude desktopversies vóór versie 1511 de aangepaste audio niet opnemen in uw toasts-melding, zodat de melding ten minste het standaardmeldingsgeluid gebruikt.

Bekend probleem: Als U Desktopversie 1511 gebruikt, werkt het aangepaste pop-upgeluid alleen als Uw app is geïnstalleerd via de Store. Dat betekent dat u uw aangepaste audio niet lokaal kunt testen op Desktop voordat u naar de Store verzendt, maar de audio werkt prima zodra deze vanuit de Store is geïnstalleerd. We hebben dit opgelost in de Jubileumupdate, zodat aangepaste audio van uw lokaal geïmplementeerde app correct werkt.

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

Ondersteunde audiobestanden zijn onder andere:

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

Ondersteunde bronnen voor audiobestanden:

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

Niet ondersteunde audiobestandsbronnen:

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

De melding verzenden

Het verzenden van een melding met audio is hetzelfde als het verzenden van een gewone melding (roep gewoon de methode Show aan). Zie Verzend lokale melding voor meer informatie.

  • Last updated on