App-meldingsinhoud

In dit artikel worden de ui-elementen beschreven die kunnen worden gebruikt in een app-melding en codevoorbeelden voor het genereren van de inhoud van de melding. Zie het overzicht van app-meldingen voor meer informatie over app-meldingen. Zie Quickstart: App-meldingen in de Windows App SDK voor een overzicht van het implementeren van app-meldingen.

Aan de slag

App-meldingen worden gedefinieerd met een XML-nettolading die wordt gedefinieerd door het app-meldingsschema. Er zijn momenteel twee manieren om de XML-nettolading voor een app-melding te genereren. De codevoorbeelden in dit artikel laten beide methoden zien:

• De Microsoft.Windows. AppNotifications.Builder API's - geïntroduceerd in Windows App SDK 1.2, biedt deze naamruimte API's waarmee u eenvoudig de XML-nettolading voor een melding programmatisch kunt maken zonder dat u zich zorgen hoeft te maken over de specifieke kenmerken van de XML-indeling. Codevoorbeelden die deze API's gebruiken, bevinden zich in de tabbladen met het label 'Windows App SDK'.
• Onbewerkte XML: als u wilt, kunt u uw eigen aangepaste code maken om XML-tekenreeksen te genereren in de vereiste indeling. De onbewerkte XML-voorbeelden bevinden zich op de tabbladen met het label XML.

Installeer Notifications Visualizer. Met deze gratis Windows-app kunt u interactieve app-meldingen ontwerpen door terwijl u deze bewerkt, een direct visueel voorbeeld van uw toast-melding te krijgen, vergelijkbaar met de XAML-editor/ontwerpweergave van Visual Studio. Zie Notifications Visualizer voor meer informatie of Notifications Visualizer downloaden uit de Store.

Dit artikel bevat alleen informatie over het maken van de app-meldingsinhoud. Zie het overzicht van app-meldingen voor informatie over het verzenden van een melding.

App-meldingsstructuur

Enkele belangrijke onderdelen op hoog niveau van een XML-nettolading voor app-meldingen zijn:

• pop-up: Het launch kenmerk van dit element definieert welke argumenten worden doorgegeven aan uw app wanneer de gebruiker op de pop-up klikt, zodat u een dieptekoppeling kunt maken naar de juiste inhoud die de pop-up weergaf. Zie het overzicht van app-meldingen voor meer informatie.
• visual: Dit element representeert het visuele gedeelte van de melding, inclusief de algemene binding die tekst en afbeeldingen bevat.
• acties: Dit element vertegenwoordigt een interactief deel van de toastmelding, inclusief invoer en acties.
• audio-: Dit element specificeert de audio die wordt afgespeeld wanneer de melding aan de gebruiker wordt getoond.

var builder = new AppNotificationBuilder()
    .AddArgument("conversationId", "9813")

    .AddText("Some text")

    .AddButton(new AppNotificationButton("Archive")
        .AddArgument("action", "archive"))

    .SetAudioUri(new Uri("ms-appx:///Sound.mp3"));

<toast launch='conversationId=9813'>
    <visual>
        <binding template='ToastGeneric'>
            <text>Some text</text>
        </binding>
    </visual>
    <audio src='ms-appx:///Audio/NotificationSound.mp3'/>
    <actions>
        <action content='Archive' arguments='action=archive'/>
    </actions>
</toast>

Hier volgt een visuele weergave van de inhoud van de app-melding:

Toeschrijvingsgebied

Het toewijzingsgebied bevindt zich bovenaan de app-melding. Vanaf Windows 11 worden de naam en het pictogram van uw app weergegeven in dit gebied. Het kenmerkgebied bevat ook een knop Sluiten waarmee de gebruiker de melding snel kan negeren en een menu met weglatingstekens waarmee de gebruiker snel meldingen voor uw app kan uitschakelen of naar de pagina Windows Instellingen voor de meldingen van uw app kan gaan. Het attributiegebied is geconfigureerd door de shell en kan niet worden overschreven in de toast XML-payload, hoewel uw app items kan toevoegen aan het contextmenu van het attributiegebied. Zie Contextmenuacties voor meer informatie.

Visueel

Elke app-melding moet een visueel element bevatten, waarbij u een generieke toastbinding moet verstrekken en dat tekst en afbeeldingen kan bevatten. Deze elementen worden weergegeven op verschillende Windows apparaten, waaronder desktop, telefoons, tablets en Xbox.

Zie app-meldingsschema voor alle attributen die worden ondersteund in de visual sectie en de onderliggende elementen.

Tekstelementen

Elke app-melding moet ten minste één tekstelement hebben en kan twee extra tekstelementen bevatten, allemaal van het type AdaptiveText. Tekstelementen ondersteunen gegevensbinding, waarmee u tekstinhoud kunt bijwerken nadat de melding is weergegeven. Zie de voortgangsbalk voor app-meldingen en gegevensbinding voor meer informatie.

U kunt bepalen hoeveel regels tekst worden weergegeven met behulp van de methode AppNotificationTextProperties.SetMaxLines . De standaardregel (en maximum) is maximaal 2 regels tekst voor de titel en maximaal 4 regels (gecombineerd) voor de twee extra beschrijvingselementen (de tweede en derde AdaptiveText).

var builder = new AppNotificationBuilder()
    .AddArgument("conversationId", 9813)
    .AddText("Adaptive Tiles Meeting", new AppNotificationTextProperties().SetMaxLines(1))
    .AddText("Conf Room 2001 / Building 135")
    .AddText("10:00 AM - 10:30 AM");

<toast launch='meetingId=9813'>
    <visual>
        <binding template='ToastGeneric'>
            <text hint-maxLines='1'>Adaptive Tiles Meeting</text>
            <text>Conf Room 2001 / Building 135</text>
            <text>10:00 AM - 10:30 AM</text>
        </binding>
    </visual>
</toast>

Afbeelding in lijn

Standaard worden afbeeldingen inline weergegeven, na eventuele tekstelementen, waarbij de volledige breedte van het visuele gebied wordt gevuld. Gebruik AppNotificationBuilder.SetInlineImage om een inline-afbeelding toe te voegen.

var builder = new AppNotificationBuilder()
    .AddText("Featured image of the day.")
    .SetInlineImage(new Uri("ms-appx:///Images/InlineImage.png"));

AppNotificationManager.Default.Show(builder.BuildNotification());

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Featured image of the day.</text>
            <image src='ms-appx:///Images/InlineImage.png'/>
        </binding>
    </visual>
</toast>

App-logo aanpassen

Als u een waarde van plaatsing opgeeft van "appLogoOverride", wordt de afbeelding aan de linkerkant van het visuele gebied in een vierkant weergegeven. Gebruik AppNotificationBuilder.SetAppLogoOverride om deze afbeelding in te stellen. De naam van deze eigenschap weerspiegelt het gedrag in eerdere versies van Windows, waarbij de afbeelding de standaard-app-logoafbeelding zou vervangen. In Windows 11 wordt het app-logo weergegeven in het kenmerkgebied, dus het wordt niet overschreven door de plaatsing van de afbeelding appLogoOverride.

Afbeeldingsdimensies zijn 48x48 pixels bij 100%% schaal. We raden u over het algemeen aan een versie van elke pictogramasset voor elke schaalfactor op te geven: 100%, 125%, 150%, 200%en 400%.

var builder = new AppNotificationBuilder()
    .AddText("Featured image of the day.")
    .SetAppLogoOverride(new Uri("ms-appx:///Images/AppLogo.png"));

Hint bijsnijden

Microsoft stijlrichtlijnen raden u aan profielafbeeldingen weer te geven met een cirkelvormige afbeelding om een consistente weergave te bieden van personen in apps en de shell. Geef AppNotificationImageCrop.Circle door aan SetAppLogoOverride om de afbeelding weer te geven met een cirkelvormige bijsnijding.

var builder = new AppNotificationBuilder()
    .AddText("Matt sent you a friend request")
    .AddText("Hey, wanna dress up as wizards and ride around on hoverboards?")
    .SetAppLogoOverride(new Uri("ms-appx:///Images/Profile.png"), AppNotificationImageCrop.Circle);

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Matt sent you a friend request</text>
            <text>Hey, wanna dress up as wizards and ride around on hoverboards?</text>
            <image placement='appLogoOverride' src='ms-appx:///Images/Profile.png' hint-crop='circle'/>
        </binding>
    </visual>
</toast>

Hero-afbeelding

App-meldingen kunnen een hero-afbeelding weergeven, wat een aanbevolen ToastGenericHeroImage is die prominent wordt weergegeven in de toasten en in het Meldingencentrum. Gebruik AppNotificationBuilder.SetHeroImage om een hero-afbeelding toe te voegen. Afbeeldingsdimensies zijn 364x180 pixels bij 100% schalen.

var builder = new AppNotificationBuilder()
    .AddText("Marry Anne")
    .AddText("Check out where we camped last night!")
    .SetHeroImage(new Uri("ms-appx:///Images/HeroImage.png"));

Beperkingen voor afbeeldingsgrootte

De afbeeldingen die u in uw app-melding gebruikt, kunnen worden opgehaald uit...

• http://
• ms-appx:///
• ms-appdata:///

Voor externe http- en https-webafbeeldingen gelden limieten voor de bestandsgrootte van elke afzonderlijke afbeelding. De limiet is 3 MB voor normale verbindingen en 1 MB op verbindingen met een datalimiet.

Als een afbeelding de bestandsgrootte overschrijdt of niet kan worden gedownload of een time-out optreedt, wordt de afbeelding verwijderd en wordt de rest van de melding weergegeven.

Toeschrijvingstekst

Als u naar de bron van uw inhoud wilt verwijzen, kunt u toeschrijvingstekst gebruiken. Gebruik AppNotificationBuilder.SetAttributionText om toeschrijvingstekst in te stellen. Deze tekst wordt altijd weergegeven onder tekstelementen, maar boven inlineafbeeldingen. De tekst maakt gebruik van een iets kleinere grootte dan standaardtekstelementen om onderscheid te maken tussen gewone tekstelementen.

In oudere versies van Windows die geen ondersteuning bieden voor toeschrijvingstekst, wordt de tekst gewoon weergegeven als een ander tekstelement (ervan uitgaande dat u nog niet over het maximum van drie tekstelementen beschikt).

var builder = new AppNotificationBuilder()
    .AddText("Marry Anne")
    .AddText("Check out where we camped last night!")
    .SetAttributionText("via SMS");
    .SetHeroImage(new Uri("ms-appx:///Images/HeroImage.png"));

<toast>  
  <visual>
    <binding template="ToastGeneric">
      <image src="ms-appx:///Images/HeroImage.png"/>
      <text>Mary Anne</text>
      <text>Check out where we camped last night!</text>
      <text placement="attribution">Via SMS</text>
    </binding>
  </visual>
</toast>

Aangepaste tijdstempel

U kunt de door het systeem geleverde tijdstempel overschrijven met uw eigen tijdstempel die nauwkeurig aangeeft wanneer het bericht/informatie/inhoud is gegenereerd. Deze tijdstempel is zichtbaar in het Meldingencentrum.

Zie Aangepaste tijdstempels in app-meldingen voor meer informatie over het gebruik van een aangepaste tijdstempel.

var builder = new AppNotificationBuilder()
    .AddText("Matt sent you a friend request")
    .AddText("Hey, wanna dress up as wizards and ride around on hoverboards?")
    .SetTimeStamp(new DateTime(2017, 04, 15, 19, 45, 00, DateTimeKind.Utc));

<toast displayTimestamp='2017-04-15T12:45:00-07:00'>
    <visual>
        <binding template='ToastGeneric'>
            <text>Matt sent you a friend request</text>
            <text>Hey, wanna dress up as wizards and ride around on hoverboards?</text>
        </binding>
    </visual>
</toast>

Voortgangsbalk

U kunt een voortgangsbalk opgeven in uw app-melding om de gebruiker op de hoogte te houden van de voortgang van bewerkingen, zoals downloads. Voortgangsbalken ondersteunen gegevensbinding, waarmee u de voortgangswaarden dynamisch kunt bijwerken nadat de melding is weergegeven.

Zie de voortgangsbalk voor app-meldingen en gegevensbinding voor meer informatie over het gebruik van een voortgangsbalk.

Headers

U kunt meldingen groeperen onder kopteksten in het Meldingencentrum. U kunt bijvoorbeeld berichten van een groepschat onder een koptekst of groepsmeldingen van een gemeenschappelijk thema onder een koptekst of meer groeperen.

Zie App-meldingsheaders voor meer informatie over het gebruik van headers.

Adaptieve inhoud

Naast de hierboven opgegeven inhoud kunt u ook aanvullende adaptieve inhoud weergeven die zichtbaar is wanneer de toastmelding wordt uitgebreid.

Deze aanvullende inhoud wordt opgegeven met Adaptief, waarover u meer informatie kunt vinden door de documentatie over adaptieve tegels te lezen.

Houd er rekening mee dat adaptieve inhoud moet worden opgenomen in een AdaptiveGroup. Anders wordt deze niet weergegeven met behulp van een adaptief systeem.

Kolommen en tekstelementen

Hier volgt een voorbeeld waarin kolommen en enkele geavanceerde adaptieve tekstelementen worden gebruikt. Omdat de tekstelementen zich in een AdaptiveGroup bevinden, ondersteunen ze alle rijke adaptieve stijleigenschappen.

// The Microsoft.Windows.AppNotifications.Builder syntax does not currently support adaptive text elements.

<toast launch="app-defined-string">
  <visual>
    <binding template="ToastGeneric">
      <text>Reminder: Windows Launch Party</text>
      <text>4:00 PM, 10/21/2021</text>
      <group>
        <subgroup>
          <text hint-style="base">52 attendees</text>
          <text hint-style="captionSubtle">23 minute drive</text>
        </subgroup>
        <subgroup>
          <text hint-style="captionSubtle" hint-align="right">1 Microsoft Way</text>
          <text hint-style="captionSubtle" hint-align="right">Bellevue, WA 98008</text>
        </subgroup>
      </group>
    </binding>
  </visual>
</toast>

Buttons

Knoppen maken uw toast interactief, waardoor de gebruiker snelle acties kan uitvoeren op uw app-melding zonder hun huidige werkproces te onderbreken. Gebruikers kunnen bijvoorbeeld rechtstreeks vanuit een toastmelding een bericht beantwoorden of een e-mailbericht verwijderen zonder de e-mail-app te openen. Knoppen worden weergegeven in het uitgevouwen gedeelte van uw melding. Gebruik AppNotificationButton om knoppen te definiëren en AppNotificationBuilder.AddButton om deze toe te voegen aan de melding.

Zie het overzicht van app-meldingen voor meer informatie over het implementeren van knoppen end-to-end.

Knoppen kunnen een app op de volgende manieren activeren:

• De app wordt geactiveerd op de voorgrond, met een argument dat kan worden gebruikt om naar een specifieke pagina/context te navigeren.
• Een andere app wordt geactiveerd via het starten van een protocol.
• Activering van achtergrond wordt expliciet ondersteund voor UWP-apps. Voor Windows App SDK-apps wordt de app altijd op de voorgrond gestart. De app kan AppInstance.GetActivatedEventArgs aanroepen om te detecteren of de activering is gestart door een melding en om te bepalen aan de hand van de doorgegeven argumenten of om de voorgrond-app volledig te starten of alleen de melding en het afsluiten af te handelen.
• Systeemacties, zoals het uitstellen of negeren van de melding, worden zowel ondersteund voor UWP-apps als voor Windows App SDK. De API's AppNotificationBuilder ondersteunen dit scenario niet, maar Windows App SDK-apps kunnen dit scenario implementeren met behulp van de Microsoft.Windows. AppNotifications.Builder API's of onbewerkte XML.

var builder = new AppNotificationBuilder()
    .AddText("New product in stock!")
    .AddButton(new AppNotificationButton("See more details")
        .AddArgument("action", "viewDetails"))
        .AddArgument("contentId", "351")
    .AddButton(new AppNotificationButton("Remind me later")
        .AddArgument("action", "remindLater"))
        .AddArgument("contentId", "351");

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>New product in stock!</text>
        </binding>
    </visual>
      <actions>
          <action content='See more details' arguments='action=viewDetails;contentId=351'/>
          <action content='Remind me later' arguments='action=remindLater;contentId=351'/>
      </actions>
</toast>

Knoppen met pictogrammen

U kunt pictogrammen toevoegen aan uw knoppen met behulp van AppNotificationButton.SetIcon. Deze pictogrammen zijn wit transparante afbeeldingen van 16 x 16 pixels bij 100% schalen en mogen geen opvulling bevatten in de afbeelding zelf. Als u ervoor kiest om pictogrammen op te geven in een app-melding, moet u pictogrammen opgeven voor AL uw knoppen in de melding, omdat de stijl van uw knoppen wordt omgezet in pictogramknoppen.

var builder = new AppNotificationBuilder()
    .AddText("Return books to the library.")
    .AddButton(new AppNotificationButton("Accept")
        .AddArgument("action", "accept")
        .SetIcon(new Uri("ms-appx:///Images/Accept.png")))
    .AddButton(new AppNotificationButton("Snooze")
        .AddArgument("action", "snooze")
        .SetIcon(new Uri("ms-appx:///Images/Snooze.png")))
    .AddButton(new AppNotificationButton("Dismiss")
        .AddArgument("action", "dismiss")
        .SetIcon(new Uri("ms-appx:///Images/Dismiss.png")));

Nieuw in Windows 11 Update: U kunt knopinfo toevoegen aan uw pictogrammen met de eigenschap HintToolTip in XML. Dit is ideaal als uw knoppen pictogrammen hebben, maar geen inhoud, omdat dit ervoor zorgt dat u tekst kunt doorgeven die Windows Verteller kan lezen. Als er echter inhoud aanwezig is, zal Verteller de inhoud lezen, ongeacht wat in de tooltip wordt doorgegeven.

var button = new AppNotificationButton("Reply")
    .AddArgument("action", "reply");

if (AppNotificationButton.IsToolTipSupported())
{
    button.ToolTip = "Click to reply.";
}

var builder = new AppNotificationBuilder()
    .AddText("Notification text.")
    .AddButton(button); 

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Notification text.</text>
        </binding>
    </visual>
    <actions>
        <action content='Reply' arguments='action=reply' hint-toolTip='Click to reply'/>
    </actions>
</toast>

Knoppen met kleuren

Nieuw in Windows 11 Update: U kunt rode of groene kleuren toevoegen aan uw knoppen met behulp van AppNotificationButton.SetButtonStyle met AppNotificationButtonStyle. Voeg in XML het kenmerk useButtonStyle toe aan het toast-element en het kenmerk hint-buttonStyle aan het actie-element, zoals hieronder wordt weergegeven.

var builder = new AppNotificationBuilder()
    .SetScenario(AppNotificationScenario.IncomingCall)
    .AddText("Andrew Bares", new AppNotificationTextProperties()
        .SetIncomingCallAlignment())
      .AddText("Incoming Call - Mobile", new AppNotificationTextProperties()
        .SetIncomingCallAlignment())
      .SetInlineImage(new Uri("ms-appx:///Images/Profile.png"),
        AppNotificationImageCrop.Circle)
    .AddButton(new AppNotificationButton()
        .SetToolTip("Answer Video Call")
        .SetButtonStyle(AppNotificationButtonStyle.Success)
        .SetIcon(new Uri("ms-appx:///Images/Video.png"))
        .AddArgument("videoId", "123"))
    .AddButton(new AppNotificationButton()
        .SetToolTip("Answer Phone Call")
        .SetButtonStyle(AppNotificationButtonStyle.Success)
        .SetIcon(new Uri("ms-appx:///Images/Call.png"))
        .AddArgument("callId", "123"))
    .AddButton(new AppNotificationButton()
        .SetToolTip("Hang Up")
        .SetButtonStyle(AppNotificationButtonStyle.Critical)
        .SetIcon(new Uri("ms-appx:///Images/HangUp.png"))
        .AddArgument("hangUpId", "123"));

<toast scenario='incomingCall' useButtonStyle='true'>
    <visual>
        <binding template='ToastGeneric'>
            <text hint-callScenarioCenterAlign='true'>Andrew Bares</text>
            <text hint-callScenarioCenterAlign='true'>Incoming Call - Mobile</text>
            <image src='ms-appx:///Images/InlineImage.png' hint-crop='circle'/>
        </binding>
    </visual>
    <actions>
        <action 
            content='' 
            arguments='videoId=123' 
            imageUri='ms-appx:///Images/Video.png' 
            hint-buttonStyle='Success' 
            hint-toolTip='Answer Video Call'/>
        <action 
            content='' 
            arguments='callId=123' 
            imageUri='ms-appx:///Images/Call.png' 
            hint-buttonStyle='Success' 
            hint-toolTip='Answer Phone Call'/>
        <action 
            content='' 
            arguments='hangUpId=123' 
            imageUri='ms-appx:///Images/HangUp.png' 
            hint-buttonStyle='Critical' 
            hint-toolTip='Hang Up'/>
    </actions>
</toast>

Contextmenuacties

U kunt extra contextmenuacties toevoegen aan het bestaande contextmenu dat wordt weergegeven wanneer de gebruiker met de rechtermuisknop op uw app-melding klikt of het contextmenupictogram selecteert. Gebruik AppNotificationButton.SetContextMenuPlacement om een knop in het contextmenu te plaatsen in plaats van de actiebalk.

De extra contextmenuacties die u toevoegt (zoals 'Groepschat dempen gedurende 1 uur') worden weergegeven boven de twee standaardsysteemvermeldingen.

var builder = new AppNotificationBuilder()
    .AddText("Camping this weekend?")
    .SetAppLogoOverride(new Uri("ms-appx:///images/Reply.png"), AppNotificationImageCrop.Circle)
    .AddButton(new AppNotificationButton("Mute group chat for 1 hour")
        .AddArgument("action", "mute")
        .SetContextMenuPlacement());

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Camping this weekend?</text>
            <image placement='appLogoOverride' src='ms-appx:///images/Reply.png' hint-crop='circle'/>
        </binding>
    </visual>
    <actions>
        <action content='Mute group chat for 1 hour' arguments='action=mute' placement='contextMenu'/>
    </actions>
</toast>

Activering van extra contextmenu-items wordt op dezelfde manier afgehandeld als toastknoppen.

Invoer

Invoer wordt opgegeven in het gebied Acties van de app-melding, wat betekent dat deze alleen zichtbaar zijn wanneer de melding wordt uitgevouwen.

Tekstvak Snel beantwoorden

Als u een snel tekstvak voor antwoorden wilt inschakelen (bijvoorbeeld in een berichten-app), voegt u een tekstinvoer toe met AppNotificationBuilder.AddTextBox en een knop en verwijst u naar de id van het tekstinvoerveld, zodat de knop naast het invoerveld wordt weergegeven. Het optionele pictogram voor de knop, indien opgegeven, moet een afbeelding van 32 x 32 pixels zijn zonder opvulling, witte pixels ingesteld op transparant en 100% schaal.

var builder = new AppNotificationBuilder()
    .AddTextBox("textBox", "Type a reply", "Reply")
    .AddButton(AppNotificationButton("Send")
        .AddArguments("action", "Send")
        .SetInputId("textBox"))
    .BuildNotification();

<toast launch="app-defined-string">
  <visual>
    <binding template="ToastGeneric">
      <image placement="appLogoOverride" hint-crop="circle" src="https://picsum.photos/48?image=883"/>
      <text>Andrew Bares</text>
      <text>Shall we meet up at 8?</text>
    </binding>
  </visual>
  <actions>
    <input id="textBox" type="text" placeHolderContent="Type a reply"/>
    <action
      content="Send"
      arguments="action=reply&amp;convId=9318"
      hint-inputId="textBox"
      imageUri="Assets/Reply.png"/>
  </actions>
</toast>

Invoer met knoppenbalk

U kunt ook één (of veel) invoer hebben met normale knoppen die onder de invoer worden weergegeven.

// The Microsoft.Windows.AppNotifications.Builder syntax does not currently support quick reply text boxes.

<toast launch="app-defined-string">
  <visual>
    <binding template="ToastGeneric">
      <image placement="appLogoOverride" hint-crop="circle" src="https://picsum.photos/48?image=883"/>
      <text>Andrew Bares</text>
      <text>Shall we meet up at 8?</text>
    </binding>
  </visual>
  <actions>
    <input id="textBox" type="text" placeHolderContent="Type a reply"/>
    <action
      content="Reply"
      arguments="action=reply&amp;threadId=9218"/>
    <action
      content="Video call"
      arguments="action=videocall&amp;threadId=9218"
      activationType="foreground"/>
  </actions>
</toast>

Selectie-invoer

Naast tekstvakken kunt u ook een selectiemenu gebruiken met AppNotificationBuilder.AddComboBox.

var builder = new AppNotificationBuilder()
    .AddText("4th coffee?")
    .AddText("When do you plan to come in tomorrow?")
    .AddComboBox(new AppNotificationComboBox("time")
        .SetTitle("Select an item:")
        .AddItem("breakfast", "Breakfast")
        .AddItem("lunch", "Lunch")
        .AddItem("dinner", "Dinner")
        .SetSelectedItem("lunch"))
    .AddButton(new AppNotificationButton("Reply")
        .AddArgument("action", "reply")
        .AddArgument("threadId", "9218")
        .SetContextMenuPlacement())
    .AddButton(new AppNotificationButton("Call restaurant")
        .AddArgument("action", "videocall")
        .AddArgument("threadId", "9218")
        .SetContextMenuPlacement());

Snooze/dismiss

Met behulp van een selectiemenu en twee knoppen kunnen we een herinneringsmelding maken die gebruikmaakt van het systeem uitstellen en acties negeren. Zorg ervoor dat u het scenario instelt op 'Herinnering' zodat de melding zich gedraagt als een herinnering.

We koppelen de knop Uitstellen aan de invoer van het selectiemenu met behulp van de eigenschap SelectionBoxId op de pop-upknop.

De Microsoft.Windows. AppNotifications.Builder syntaxis biedt momenteel geen ondersteuning voor systeemactivering. Dit scenario wordt echter ondersteund voor Windows App SDK apps en u kunt meldingen maken voor dit scenario met behulp van onbewerkte XML.

// The Microsoft.Windows.AppNotifications.Builder syntax does not currently support system activation. 
// But this scenario is supported for Windows App SDK apps, and you can build notifications for this 
// scenario using raw XML.

Als u handelingen van het systeem wilt uitstellen en afwijzen:

• Geef een ToastButtonSnooze of ToastButtonDismiss
• Geef desgewenst een aangepaste inhoudsreeks op:
• Als u geen tekenreeks opgeeft, gebruiken we automatisch gelokaliseerde tekenreeksen voor 'Uitstellen' en 'Sluiten'.
• Geef desgewenst de SelectionBoxId op:
• Als u niet wilt dat de gebruiker een snooze-interval selecteert en in plaats daarvan wilt dat uw notificatie slechts één keer wordt uitgesteld voor een door het systeem gedefinieerd tijdsinterval (dat consistent is in het gehele besturingssysteem), maakt u helemaal geen <invoer>.
• Als u uitstelintervalselecties wilt opgeven: - Specificeer SelectionBoxId in de actie 'Uitstellen' - Zorg ervoor dat de id van de invoer overeenkomt met de SelectionBoxId van de actie 'Uitstellen' - Stel de waarde van ToastSelectionBoxItemin als een niet-negatief geheel getal dat het uitstelinterval in minuten vertegenwoordigt.

Geluid

Gebruik AppNotificationBuilder.SetAudioUri om een aangepast audiobestand op te geven of gebruik AppNotificationBuilder.SetAudioEvent om een systeemgeluid te selecteren. Er kan naar aangepaste audio worden verwezen via de volgende paden:

• ms-appx:///
• ms-appdata:///

var builder = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetAudioUri(new Uri("ms-appx:///Audio/NotificationSound.mp3"));

U kunt ook kiezen uit de lijst met ms-winsoundevents, die altijd op beide platforms zijn ondersteund.

var builder = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetAudioEvent(AppNotificationSoundEvent.Alarm, AppNotificationAudioLooping.Loop);

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Notification text.</text>
        </binding>
    </visual>
    <audio src='ms-winsoundevent:Notification.Looping.Alarm' loop='true'/>
</toast>

Zie de pagina audioschema voor informatie over audio in app-meldingen. Zie Aangepaste audio in app-meldingen voor meer informatie over het verzenden van een app-melding die gebruikmaakt van aangepaste audio.

Scenariën

Als u belangrijke meldingen, waarschuwingen, herinneringen en binnenkomende oproepmeldingen wilt maken, gebruikt u AppNotificationBuilder.SetScenario met de waarde AppNotificationScenario . In het scenario worden enkele gedragingen aangepast om een consistente en uniforme gebruikerservaring te creëren. Er zijn vier mogelijke scenariowaarden :

• Reminder
• Alarm
• IncomingCall
• Urgent

Aanmaningen

In het herinneringsscenario blijft de melding op het scherm staan totdat de gebruiker deze negeert of actie onderneemt. Op Windows Mobile wordt de app-melding ook vooraf al uitgevouwen getoond. Er wordt een herinneringsgeluid afgespeeld. U moet ten minste één knop toevoegen aan de melding van de app. Anders wordt de melding behandeld als een normale melding.

var builder = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetScenario(AppNotificationScenario.Reminder);

<toast scenario='reminder'>
    <visual>
        <binding template='ToastGeneric'>
            <text>Notification text.</text>
        </binding>
    </visual>
</toast>

Alarmen

Alarmen gedragen zich hetzelfde als herinneringen, behalve alarmen zullen ook geluid herhalen met een standaard alarmgeluid. U moet ten minste één knop toevoegen aan de melding van de app. Anders wordt de melding behandeld als een normale melding.

var builder = new AppNotificationBuilder()
    .AddText("Notification text.")
    .SetScenario(AppNotificationScenario.Alarm)
    .AddButton(new AppNotificationButton("Dismiss")
        .AddArgument("action", "dismiss"));

<toast scenario='alarm'>
    <visual>
        <binding template='ToastGeneric'>
            <text>Notification text.</text>
        </binding>
    </visual>
    <actions>
        <action content='Dismiss' arguments='action=dismiss'/>
    </actions>
</toast>

Binnenkomende oproepen

Binnenkomende oproepmeldingen worden al uitgevouwen weergegeven in een speciale oproepindeling en blijven op het scherm staan totdat ze worden verwijderd. Beltoongeluid wordt standaard herhaald. Op Windows Mobiele apparaten worden ze volledig scherm weergegeven.

var builder = new AppNotificationBuilder()
    .SetScenario(AppNotificationScenario.IncomingCall)
    .AddText("Andrew Bares", new AppNotificationTextProperties()
        .SetIncomingCallAlignment())
    .AddText("incoming call - mobile", new AppNotificationTextProperties()
        .SetIncomingCallAlignment())
      .SetInlineImage(new Uri("ms-appx:///images/profile.png"),
        AppNotificationImageCrop.Circle)
    .AddButton(new AppNotificationButton("Text reply")
        .SetToolTip("Text reply")
        .SetIcon(new Uri("ms-appx:///images/reply.png"))
        .AddArgument("textId", "123"))
    .AddButton(new AppNotificationButton("Reminder")
        .SetToolTip("Reminder")
        .SetIcon(new Uri("ms-appx:///images/reminder.png"))
        .AddArgument("reminderId", "123"))
    .AddButton(new AppNotificationButton("Ignore")
        .SetToolTip("Ignore")
        .SetIcon(new Uri("ms-appx:///images/ignore.png"))
        .AddArgument("ignoreId", "123"))
    .AddButton(new AppNotificationButton("Answer")
        .SetToolTip("Answer")
        .SetIcon(new Uri("ms-appx:///images/answer.png"))
        .AddArgument("answerId", "123"));

<toast scenario='incomingCall'>
    <visual>
        <binding template='ToastGeneric'>
            <text hint-callScenarioCenterAlign='true'>Andrew Bares</text>
            <text hint-callScenarioCenterAlign='true'>incoming call - mobile</text>
            <image src='ms-appx:///images/profile.png' hint-crop='circle'/>
        </binding>
    </visual>
    <actions>
        <action 
            content='Text reply' 
            arguments='textId=123' 
            imageUri='ms-appx:///images/reply.png' 
            hint-toolTip='Text reply'/>
        <action 
                content='Reminder' 
                arguments='reminderId=123' 
                imageUri='ms-appx:///images/reminder.png' 
                hint-toolTip='Reminder'/>
        <action 
                content='Ignore' 
                arguments='ignoreId=123' 
                imageUri='ms-appx:///images/ignore.png' 
                hint-toolTip='Ignore'/>
        <action 
            content='Answer' 
            arguments='answerId=123' 
            imageUri='ms-appx:///images/answer.png' 
            hint-toolTip='Answer'/>
    </actions>
</toast>

Belangrijke meldingen

Met belangrijke meldingen krijgen gebruikers meer controle over welke eigen apps en apps van derden hen app-meldingen met hoge prioriteit (urgent/belangrijk) kunnen sturen die Focus Assist (Niet storen) buiten werking kunnen stellen. Dit kan worden gewijzigd in de instellingen voor meldingen.

var builder = new AppNotificationBuilder()
    .AddText("Adaptive Tiles Meeting", 
        new AppNotificationTextProperties()
            .SetMaxLines(1))
    .AddText("Conf Room 2001 / Building 135")
    .AddText("10:00 AM - 10:30 AM");

if (AppNotificationBuilder.IsUrgentScenarioSupported())
{
    builder.SetScenario(AppNotificationScenario.Urgent);
}

<toast scenario='urgent'>
    <visual>
        <binding template='ToastGeneric'>
            <text hint-maxLines='1'>Adaptive Tiles Meeting</text>
            <text>Conf Room 2001 / Building 135</text>
            <text>10:00 AM - 10:30 AM</text>
        </binding>
    </visual>
</toast>

Lokalisatie en toegankelijkheid

Uw tegels en app-meldingen kunnen tekenreeksen en afbeeldingen laden die zijn afgestemd op de weergavetaal, weergaveschaalfactor, hoog contrast en andere uitvoeringscontexten. Zie ondersteuning voor tegel- en pop-upmeldingen voor taal, schaal en hoog contrastvoor meer informatie.

Afhandeling van activering

Zie het overzicht van app-meldingen voor informatie over het afhandelen van app-activeringen (de gebruiker die op uw melding of knoppen op de melding klikt).  

Verwante onderwerpen

• Overzicht van app-meldingen
• ondersteuning voor tegel- en pop-upmeldingen voor taal, schaal en hoog contrast