Dela via

Appaviseringsinnehåll

Appmeddelanden är flexibla meddelanden med text, bilder och knappar/indata. I den här artikeln beskrivs de gränssnittselement som kan användas i en appavisering och innehåller kodexempel för att generera XML-format för ett appmeddelande.

Note

Termen "toast-meddelande" ersätts med "appavisering". Dessa termer refererar båda till samma funktion i Windows, men med tiden kommer vi att fasa ut användningen av "popup-meddelande" i dokumentationen.

Getting started

Appmeddelanden definieras med en XML-nyttolast som definieras av programmets meddelandeschema. För närvarande finns det tre sätt att generera XML-nyttolasten för ett appmeddelande. Kodexemplen i den här artikeln visar alla tre metoderna:

  • Den Microsoft.Windows.AppNotifications.Builder-API:er – introducerades i Windows App SDK 1.2. Det här namnområdet innehåller API:er som gör att du enkelt kan skapa XML-nyttolasten för ett meddelande programmatiskt utan att behöva bekymra dig om xml-formatets detaljer. Kodexempel som använder dessa API:er finns på flikarna med etiketten "Windows App SDK".
  • Builder-syntaxen Microsoft.Toolkit.Uwp.Notifications – Dessa API:er är en del av UWP Community Toolkit och ger stöd för UWP-appar. Även om dessa API:er också kan användas för Windows App SDK-appar och fortsätta att stödjas rekommenderar vi att nya implementeringar använder API: erna Microsoft.Windows.AppNotifications.Builder . Om du vill använda API:er för Community Toolkit lägger du till nuget-paketet UWP Community Toolkit Notifications i projektet. C#-exemplen i den här artikeln använder version 7.0.0 av NuGet-paketet. Kodexempel som använder dessa API:er finns på flikarna med etiketten "Windows Community Toolkit".
  • Raw XML – Om du vill kan du skapa din egen anpassade kod för att generera XML-strängar i det format som krävs. Xml-rådataexemplen finns på flikarna med etiketten "XML".

Installera Meddelanden Visualiserare. Den här kostnadsfria Windows-appen hjälper dig att utforma interaktiva appaviseringar genom att ge en omedelbar visuell förhandsgranskning av din toast-notis medan du redigerar den, något i stil med XAML-redigeraren/designvyn i Visual Studio. Mer information finns i Notifications Visualizer, eller ladda ned Notifications Visualizer från butiken.

Den här artikeln beskriver bara hur du skapar appens meddelandeinnehåll. Information om hur du skickar ett meddelande när du har genererat XML-nyttolasten finns i Skicka ett lokalt appmeddelande.

Appmeddelandestruktur

Några viktiga komponenter på hög nivå i en XML-nyttolast för appmeddelanden är:

  • notis-: Attributet aktivera för det här elementet definierar vilka argument som ska skickas tillbaka till appen när användaren klickar på notisen, så att du kan länka till rätt innehåll som notisen visade. Mer information finns i Skicka ett meddelande om en lokal app.
  • visuella: Det här elementet representerar den visuella delen av meddelandet, inklusive den generiska bindningen som innehåller text och bilder.
  • åtgärder: Det här elementet representerar den interaktiva delen av meddelandet, inklusive indata och åtgärder.
  • ljud: Det här elementet anger ljudet som spelas upp när popup-fönstret visas för användaren.
var builder = new AppNotificationBuilder()
    .AddArgument("conversationId", "9813")

    .AddText("Some text")

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

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

Här är en visuell representation av appmeddelandets innehåll:

En skärmbild av en appavisering med etiketter för attributionsområdet längst upp som visar appikonen och appnamnet Notifications Visualizer. Den mellersta delen av aviseringen är märkt som det visuella området, som innehåller tre textrader. Det nedre avsnittet i aviseringen är märkt som handlingsområde och innehåller två knappar märkta Acceptera och Neka.

Attribution area

Attributionsområdet finns överst i appmeddelandet. Från och med Windows 11 visas appens namn och ikon i det här området. Attributionsområdet innehåller också en stängningsknapp som gör att användaren snabbt kan stänga meddelandet och en ellipsmeny som gör att användaren snabbt kan inaktivera meddelanden för din app eller gå till sidan Windows-inställningar för appens meddelanden. Attributionsområdet konfigureras av shell och kan inte åsidosättas i toast-meddelandes XML, även om appen kan lägga till objekt i snabbmenyn för attributionsområdet. Mer information finns i snabbmenyåtgärder.

Visual

Varje appavisering måste ange ett visuellt element, där du måste ange en allmän toast-bindning och som kan innehålla text och bilder. Dessa element återges på olika Windows-enheter, inklusive stationära datorer, telefoner, surfplattor och Xbox.

För alla attribut som stöds i den visuella sektionen och dess underordnade element, se appmeddelande schema.

Text elements

Varje appavisering måste ha minst ett textelement och kan innehålla ytterligare två textelement, alla av typen AdaptiveText.

En skärmbild av ett appmeddelande med tre textrader. Den översta textraden är fet.

Sedan Windows 10 Anniversary Update kan du styra hur många textrader som visas med hjälp av egenskapen HintMaxLines i texten. Standardvärdet (och maxvärdet) är upp till 2 textrader för rubriken och upp till 4 rader (kombinerat) för de två ytterligare beskrivningselementen (den andra och tredje 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");

Inline image

Som förval infogas bilder efter eventuella textelement och fyller hela bredden av det visuella området.

En skärmbild av ett appmeddelande som visar standardbildens placering, infogad, som fyller hela bredden på det visuella området. 

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

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

Åsidosättning av appens logotyp

Genom att specificera ett -placeringsvärde med "appLogoOverride" kommer bilden att visas som en kvadrat på vänster sida av det visuella området. Namnet på den här egenskapen återspeglar beteendet i tidigare versioner av Windows, där avbildningen skulle ersätta standardappens logotypbild. I Windows 11 visas applogotypen i attributionsområdet, så den åsidosättas inte av appLogoOverride-bildplaceringen .

Bilddimensionerna är 48 x 48 bildpunkter med 100% skalning. Vi rekommenderar vanligtvis att du tillhandahåller en version av varje ikontillgång för varje skalningsfaktor: 100%, 125%, 150%, 200%och 400%.

En skärmbild av ett appmeddelande som visar att appens logotyp åsidosätter bildplacering på en fyrkant till vänster i det visuella området i meddelandet. 

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

Hint crop

Riktlinjer för Microsoft-format rekommenderar att du representerar profilbilder med en cirkulär bild för att ge en konsekvent representation av personer i appar och gränssnittet. Ange egenskapen HintCrop till Cirkel för att visa bilden med en cirkulär beskärning.

En skärmbild av ett appmeddelande som visar hur appens logotyp överstyr bildplacering, beskuren som en cirkel till vänster i det visuella området av notisen. 

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

Hero image

New in Anniversary Update: Appmeddelanden kan visa en hjältbild, vilket är en framträdande ToastGenericHeroImage som visas tydligt i aviseringens banderoll och i Notiscenter. Bilddimensioner är 364 x 180 bildpunkter vid 100% skalning.

En skärmbild av ett appmeddelande som visar hero-bildplaceringen ovanför attributionsområdet. 

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

Begränsningar för bildstorlek

Bilderna som du använder i dina toast-meddelanden kan hämtas från...

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

För http- och https-fjärrwebbbilder finns det gränser för filstorleken för varje enskild bild. I "Fall Creators Update" (16299) ökade vi gränsen till 3 MB för vanliga anslutningar och 1 MB för anslutningar med mätade användningsavgifter. Innan det var bilderna alltid begränsade till 200 KB.

Normal connection Metered connection Före Fall Creators-uppdateringen
3 MB 1 MB 200 KB

Om en bild överskrider filstorleken, eller om det inte går att ladda ned eller överskrider tidsgränsen, tas bilden bort och resten av meddelandet visas.

Attribution text

Nytt i Anniversary Update: Om du behöver referera till källan till ditt innehåll kan du använda attributtext. Den här texten visas alltid under alla textelement, men ovanför infogade bilder. Texten använder en något mindre storlek än standardtextelement för att skilja från vanliga textelement.

I äldre versioner av Windows som inte stöder attributionstext visas texten helt enkelt som ett annat textelement (förutsatt att du inte redan har högst tre textelement).

En skärmbild av ett toast-meddelande som visar attributionstexten 

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

Custom timestamp

Ny i Creators Update: Nu kan du åsidosätta tidsstämpeln som tillhandahålls av systemet med din egen tidsstämpel som korrekt representerar när meddelandet/informationen/innehållet genererades. Den här tidsstämpeln visas i Meddelandecenter.

Skärmbild av ett meddelande i Meddelandecenter med en anpassad tidsstämpel

Mer information om att använda en anpassad tidsstämpel finns i anpassade tidsstämplar på aviseringar.

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

Progress bar

Ny i Creators Update: Du kan ange en förloppsindikator för din appavisering för att hålla användaren informerad om förloppet för åtgärder som nedladdningar.

En skärmdump av ett toastmeddelande som visar ett förloppsfält.

Mer information om hur du använder en förloppsindikator finns i toast-förloppsindikatorn.

Headers

Ny i Creators Update: Du kan gruppera meddelanden under rubriker i Notification Center. Du kan till exempel gruppera meddelanden från en gruppchatt under en rubrik eller gruppaviseringar av ett gemensamt tema under en rubrik eller mer.

En skärmbild av ett åtgärdscenter som visar flera meddelanden för programmet Notifications Viewer organiserat under rubriken

För att lära dig mer om hur du använder rubriker, se Toast headers.

Adaptive content

Nytt i Anniversary Update: Förutom innehållet som anges ovan kan du också visa ytterligare adaptivt innehåll som blir synligt när toasten expanderas.

Det här ytterligare innehållet anges med hjälp av Adaptive, som du kan lära dig mer om genom att läsa dokumentationen om Adaptive Tiles.

Observera att allt anpassningsbart innehåll måste finnas i en AdaptiveGroup. Annars renderas den inte med adaptiv.

Kolumner och textelement

Här är ett exempel där kolumner och vissa avancerade anpassningsbara textelement används. Eftersom textelementen finns i en AdaptiveGroup stöder de alla de omfattande anpassningsbara formategenskaperna.

En skärmdump av ett meddelande som visar grupper med textelement som är justerade till vänster och höger om den visuella delen av meddelandet. 

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

Buttons

Knappar gör ditt toastmeddelande interaktivt, så att användaren snabbt kan agera i din appavisering utan att avbryta deras nuvarande arbetsflöde. Användare kan till exempel svara på ett meddelande direkt från en toast-notifiering eller ta bort ett e-postmeddelande utan att ens öppna e-postappen. Knappar visas i den expanderade delen av meddelandet.

För att lära dig mer om hur du implementerar knappar änd till ända, se Skicka lokal avisering.

Knappar kan aktivera en app på följande sätt:

  • Appen aktiveras i förgrunden med ett argument som kan användas för att navigera till en specifik sida/kontext.
  • En annan app aktiveras via protokollstart.
  • Bakgrundsaktivering stöds uttryckligen för UWP-appar. För Windows App SDK-appar startas appen alltid i förgrunden. Appen kan anropa AppInstance.GetActivatedEventArgs för att identifiera om aktiveringen startades av ett meddelande och avgöra från de skickade argumenten om förgrundsappen ska startas helt eller bara hantera meddelandet och avsluta.
  • Systemåtgärder, till exempel att snooza eller stänga av meddelandet, stöds både för UWP-appar och för Windows App SDK. Api:er för AppNotificationBuilder stöder inte det här scenariot, men Windows App SDK-appar kan implementera det här scenariot med hjälp av API:er för Microsoft.Windows.AppNotifications.Builder eller rå XML.

Note

Du kan bara ha upp till 5 knappar (inklusive snabbmenyalternativ som vi diskuterar senare).

En skärmbild av ett popup-meddelande som visar en textrad följt av en rad med två knappar som definierats av åtgärdselement 

new ToastContentBuilder()
    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");

Knappar med ikoner

Du kan lägga till ikoner i knapparna. Dessa ikoner är vita transparenta bilder på 16 x 16 bildpunkter vid 100% skalning och bör inte ha någon utfyllnad som ingår i själva bilden. Om du väljer att ange ikoner i ett popup-meddelande måste du ange ikoner för ALLA knappar i meddelandet, eftersom det omvandlar stilen för dina knappar till ikonknappar.

Note

För hjälpmedel måste du inkludera en kontrastvit version av ikonen (en svart ikon för vita bakgrunder), så att ikonen visas när användaren aktiverar läget Högkontrastvit. Mer information finns i Platta- och toast-meddelandestöd för språk, hög kontrast och skalning.

Skärmbild av ett appmeddelande som använder knappar med ikoner. 

new ToastContentBuilder()
    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")));

Nytt i Windows 11 Update: Du kan lägga till knappbeskrivningar i dina ikoner med egenskapen HintToolTip i XML. Det här är perfekt om dina knappar har ikoner men inget innehåll, eftersom det gör att du kan skicka text som Windows Narrator (Skärmläsaren) kan läsa. Men om det finns innehåll, läser Skärmläsaren innehållet, oavsett vad som skickas i verktygstipset.

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

Knappar med färger

Nytt i Windows 11 Update: Du kan lägga till röda eller gröna färger på knapparna genom att lägga till attributet useButtonStyle i popup--XML-elementet och attributet hint-buttonStyle till åtgärds-XML-elementet enligt nedan.

En skärmbild av ett meddelande med tre knappar, de två vänstra knapparna är gröna med ikoner för att starta ett videosamtal eller starta ett ljudsamtal. Den tredje knappen är röd och har en ikon för att avvisa samtalet. 

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

Snabbmenyåtgärder

Nytt i Anniversary Update: Du kan lägga till ytterligare snabbmenyåtgärder i den befintliga snabbmenyn som visas när användaren högerklickar på popup-meddelandet eller väljer snabbmenyikonen.

Note

På äldre enheter visas dessa ytterligare snabbmenyåtgärder helt enkelt som vanliga knappar i meddelandet.

De ytterligare snabbmenyåtgärder som du lägger till (till exempel "Stäng av gruppchatt i 1 timme") visas ovanför de två standardsystemposterna.

Toast med kontextmeny 

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

Note

Ytterligare snabbmenyobjekt bidrar till den totala gränsen på 5 knappar i en notifikation.

Aktivering av ytterligare snabbmenyobjekt hanteras på samma sätt som toast-knappar.

Inputs

Indata anges i åtgärdsregionen för appmeddelandet, vilket innebär att de bara visas när meddelandet expanderas.

Textruta för snabbsvar

Om du vill aktivera en snabbsvarstextruta (till exempel i en meddelandeapp) lägger du till en textinmatning och en knapp och refererar till ID:t för textinmatningsfältet så att knappen visas bredvid indatafältet. Den valfria ikonen för knappen ska, om den tillhandahålls, vara en bild på 32 x 32 bildpunkter utan utfyllnad, vita pixlar inställda på transparent och 100% skala.

En skärmbild av ett toastmeddelande med en profilbild och några rader text. En textruta för att skriva direkt i toastmeddelandet finns samt en knapp för att skicka svaret. 

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

Indata med knappfält

Du kan också ha en (eller flera) inmatning med vanliga knappar som visas under inmatningarna.

En skärmbild av ett appmeddelande som visar en textrad, en textruta och en rad med två knappar märkta 

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

Selection input

Förutom textrutor kan du också använda en markeringsmeny.

En skärmbild av ett appmeddelande som visar en textrad, en markeringsinmatning med 

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

Med hjälp av en markeringsmeny och två knappar kan vi skapa ett påminnelsemeddelande som använder systemets snooze- och avvisa-åtgärder. Se till att ställa in scenariot på "Påminnelse" för att meddelandet ska bete sig som en påminnelse.

En skärmbild av ett appmeddelande med textrader som beskriver tid och plats för ett möte. En markeringsruta har

Vi länkar Snooze-knappen till valmenyns indata med egenskapen SelectionBoxId på toast-knappen.

Syntaxen Microsoft.Windows.AppNotifications.Builder stöder för närvarande inte systemaktivering. Men det här scenariot stöds för Windows App SDK-appar och du kan skapa aviseringar för det här scenariot med hjälp av Microsoft.Toolkit.Uwp.Notifications API:er eller rå 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 the `Microsoft.Toolkit.Uwp.Notifications` APIs or raw XML.

Så här använder du systemets snooze- och avvisa-åtgärder:

  • Ange en ToastButtonSnooze eller ToastButtonDismiss
  • Du kan också ange en anpassad innehållssträng:
  • Om du inte anger någon sträng använder vi automatiskt lokaliserade strängar för "Snooze" och "Dismiss".
  • Du har möjlighet att ange SelectionBoxId:
  • Om du inte vill att användaren ska välja ett snooze-intervall och istället bara vill att din notifikation ska snooza en gång för ett tidsintervall som är definierat av systemet (och som är konsekvent i operativsystemet), bör du inte konstruera någon <inmatning> alls.
  • Om du vill ange val av snooze-intervall: – Ange SelectionBoxId i snooze-åtgärden – Matcha id:t för indata med SelectionBoxId för snooze-åtgärden – Ange ToastSelectionBoxItemtill ett värde som ska vara ett icke-negativt heltal som representerar snooze-intervall i minuter.

Audio

Anpassat ljud har alltid stöd för mobiler och stöds i Desktop Version 1511 (version 10586) eller senare. Anpassat ljud kan nås via följande sökvägar:

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

Du kan också välja från lista över ms-winsoundevents, som alltid har stötts på båda plattformarna.

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

Se ljudschemasidan för information om ljud i appaviseringar. Så här skickar du ett appmeddelande som använder anpassat ljud: se anpassat ljud på aviseringar.

Scenarios

Om du vill skapa viktiga meddelanden, larm, påminnelser och inkommande samtalsaviseringar använder du helt enkelt ett normalt appmeddelande med ett scenariovärde som tilldelats det. Scenariot justerar några beteenden för att skapa en konsekvent och enhetlig användarupplevelse. Det finns fyra möjliga scenariovärden :

  • Reminder
  • Alarm
  • IncomingCall
  • Urgent

Reminders

I påminnelsescenariot visas meddelandet på skärmen tills användaren avvisar det eller vidtar åtgärder. På Windows Mobile visas appmeddelandet också redan expanderat. Ett påminnelseljud spelas upp. Du måste ange minst en knapp i appaviseringen. Annars behandlas meddelandet som ett normalt meddelande.

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

Alarms

Larm fungerar på samma sätt som påminnelser, förutom att larm dessutom upprepar sig med ett förinställt larmljud. Du måste ange minst en knapp i appaviseringen. Annars behandlas meddelandet som ett normalt meddelande.

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

Incoming calls

Inkommande samtalsmeddelanden visas i förväg expanderade i ett särskilt samtalsformat och stannar kvar på användarens skärm tills de stängs. Ringsignalsljudet loopas som standard. På Windows Mobile-enheter visas helskärmsläge.

popup-meddelande för inkommande samtal 

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

Important Notifications

Important

Kräver: Du måste köra Windows Insider Preview Build 22546 eller senare för att kunna använda viktiga meddelanden.

Viktiga meddelanden gör det möjligt för användare att ha mer kontroll över vad appar från första part och tredje part kan skicka dem högprioriterade appaviseringar (brådskande/viktiga) som kan bryta igenom Focus Assist (Stör ej). Detta kan ändras i inställningarna för meddelanden.

En skärmbild av ett brådskande appmeddelande som har ett utropstecken i attributionsområdet bredvid appnamnet. Bilden visar också det systeminitierade appmeddelandet som innehåller knappar som användaren kan använda för att tillåta eller neka brådskande meddelanden från appen. 

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

Lokalisering och hjälpmedel

Dina paneler och appmeddelanden kan läsa in strängar och bilder som är skräddarsydda för visningsspråk, visningsskalningsfaktor, högkontrast och andra körningskontexter. För mer info, se platta- och toast-meddelandestöd för språk, skalning och högkontrast.

Handling activation

Mer information om hur du hanterar appaktiveringar (när användaren klickar på din brödrostavisering eller knapparna i aviseringen) finns i Skicka lokal avisering.