Megosztás:

Alkalmazásértesítés tartalma

Az alkalmazásértesítések rugalmas értesítések szöveggel, képekkel és gombokkal/bemenetekkel. Ez a cikk az alkalmazásértesítésekben használható felhasználói felületi elemeket ismerteti, és kód példákat tartalmaz az alkalmazásértesítés XML-formátumának létrehozásához.

Note

A "bejelentési értesítés" kifejezés helyébe "alkalmazásértesítés" lép. Ezek a kifejezések a Windows ugyanazon funkciójára vonatkoznak, de idővel megszüntetjük a "bejelentési értesítés" használatát a dokumentációban.

Kezdő lépések

Az alkalmazásértesítések az alkalmazásértesítési séma által meghatározott XML-hasznos adatokkal vannak definiálva. Jelenleg három módon lehet létrehozni az XML hasznos adatait egy alkalmazásértesítéshez. A cikkben szereplő kód példák mind a három módszert szemléltetik:

  • A Microsoft.Windows.AppNotifications.Builder API-k – A Windows App SDK 1.2-ben bevezetett névtér olyan API-kat biztosít, amelyek lehetővé teszik az XML-hasznos adatok programozott módon történő létrehozását anélkül, hogy az XML-formátum jellemzőivel kellene foglalkoznia. Az ilyen API-kat használó kód példák a "Windows App SDK" címkével ellátott füleken találhatók.
  • A Microsoft.Toolkit.Uwp.Notifications szerkesztő szintaxisa – Ezek az API-k az UWP közösségi eszközkészlet részét képezik, és támogatást nyújtanak az UWP-alkalmazásokhoz. Bár ezek az API-k a Windows App SDK-alkalmazásokhoz is használhatók, és továbbra is támogatottak, javasoljuk, hogy az új implementációk a Microsoft.Windows.AppNotifications.Builder API-kat használják. A Community Toolkit API-k használatához adja hozzá az UWP Community Toolkit Notifications nuget csomagot a projekthez. A cikkben szereplő C#-minták a NuGet-csomag 7.0.0-s verzióját használják. Az ilyen API-kat használó példakódok a "Windows Community Toolkit" címkével ellátott lapon találhatók.
  • Nyers XML – Tetszés szerint létrehozhatja saját egyéni kódját, amely xml-sztringeket hoz létre a szükséges formátumban. A nyers XML-példák az "XML" címkével ellátott lapokban találhatók.

Telepítse az Értesítési vizualizációt. Ez az ingyenes Windows-alkalmazás segít interaktív értesítések tervezésében azáltal, hogy a szerkesztés során azonnal vizuális előnézetet biztosít a toast értesítésekről, hasonlóan a Visual Studio XAML-szerkesztőjének/tervező nézetének megjelenítéséhez. További információért tekintse meg az Értesítések Vizualizálót, vagy töltse le az Értesítések Vizualizálót az Áruházból.

Ez a cikk csak az alkalmazásértesítési tartalom létrehozását ismerteti. Az XML tétel létrehozása után küldött értesítésről további információt a Helyi alkalmazásértesítés küldésecímű témakörben talál.

Alkalmazásértesítési struktúra

Az alkalmazásértesítési XML hasznos adatainak néhány fontos, magas szintű összetevője a következők:

  • bejelentési: Az elem indítási attribútuma határozza meg, hogy milyen argumentumokat ad vissza az alkalmazásnak, amikor a felhasználó a bejelentésre kattint, így mélyhivatkozást hozhat létre a bejelentés által megjelenített megfelelő tartalomra. További információ: Helyi alkalmazásértesítés küldése.
  • vizuális: Ez az elem az értesítés vizuális részét jelöli, beleértve a szöveget és képeket tartalmazó általános kötést.
  • műveletek: Ez az elem a bejelentés interaktív részét jelöli, beleértve a bemeneteket és a műveleteket.
  • hang: Ez az elem határozza meg a hang lejátszását, amikor a bejelentés megjelenik a felhasználó számára.
var builder = new AppNotificationBuilder()
    .AddArgument("conversationId", "9813")

    .AddText("Some text")

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

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

Itt látható az alkalmazásértesítés tartalmának vizuális ábrázolása:

Képernyőkép egy alkalmazásértesítésről, amelynek tetején a hozzárendelési terület feliratai láthatók, az alkalmazás ikonja és az alkalmazás neve értesítési vizualizációja. A bejelentés középső része vizualizációs területként van megjelölve, amely három sornyi szöveget tartalmaz. A bejelentés alsó szakasza műveletterületként van megjelölve, és két, Elfogadás és elutasítás címkével ellátott gombot tartalmaz.

Hozzárendelési terület

A hozzárendelési terület az alkalmazásértesítés tetején található. A Windows 11-től kezdve ezen a területen megjelenik az alkalmazás neve és ikonja. A hozzárendelési terület tartalmaz egy bezárás gombot is, amely lehetővé teszi a felhasználó számára az értesítés gyors elvetését, valamint egy három pontot tartalmazó menüt, amely lehetővé teszi, hogy a felhasználó gyorsan letiltsa az alkalmazás értesítéseit, vagy lépjen az alkalmazás értesítéseinek Windows-beállítások lapjára. A hozzárendelési területet a shell konfigurálja, és nem bírálható felül a toast XML-payloadban, bár az alkalmazás hozzáadhat elemeket a hozzárendelési terület környezetfüggő menüjéhez. További információ: Helyi menüműveletek.

Visual

Minden alkalmazásértesítésnek meg kell adnia egy vizualizációs elemet, amelyben általános bejelentési kötést kell megadnia, amely tartalmazhat szöveget és képeket. Ezek az elemek különböző Windows-eszközökön, például asztali eszközökön, telefonokon, táblagépeken és Xbox konzolokon jelennek meg.

A vizuális szakaszban és annak gyermekelemeiben támogatott összes attribútumra lásd a Alkalmazásértesítési séma-at.

Szövegelemek

Minden alkalmazásértesítésnek legalább egy szöveges elemmel kell rendelkeznie, és két további szöveges elemet is tartalmazhat, amelyek mindegyike adaptív szöveg típusú.

Képernyőkép egy alkalmazásértesítésről három sornyi szöveggel. A szöveg felső sora félkövér.

A Windows 10 évfordulós frissítése óta a szöveg HintMaxLines tulajdonságával szabályozhatja, hogy hány sornyi szöveg jelenjen meg. Az alapértelmezett (és maximális) legfeljebb 2 sornyi szöveg a cím, és legfeljebb 4 sor (kombinálva) a két további leírási elem (a második és a harmadik 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");

Beágyazott kép

Alapértelmezés szerint a képek beágyazottan jelennek meg a szövegelemek után, kitöltve a vizualizáció teljes szélességét.

Képernyőkép egy alkalmazásértesítésről, amelyen az alapértelmezett képelhelyezés látható, beágyazott módon, kitöltve a vizualizáció teljes szélességét. 

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

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

Alkalmazás logó felülírása

Az "appLogoOverride" elhelyezési értékének megadásával a kép a vizuális terület bal oldalán lévő négyzetben jelenik meg. Ennek a tulajdonságnak a neve a Windows korábbi verzióinak viselkedését tükrözi, ahol a rendszerkép lecseréli az alapértelmezett alkalmazás emblémáját. A Windows 11-ben az alkalmazás emblémája megjelenik a megjelölési területen, így az appLogoOverride képelhelyezés nem írja felül.

A kép mérete 48x48 képpont 100% skálázáskor. Általában azt javasoljuk, hogy minden méretezési tényezőhöz egy verziót biztosítson: 100%, 125%, 150%, 200%, valamint 400%.

Képernyőkép egy alkalmazásértesítésről, amelyen az alkalmazás emblémája felülbírálja a kép elhelyezését az értesítés vizualizációjának bal oldalán lévő négyzetben. 

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

Tippek levágása

A Microsoft stílusszabályai azt javasolják, hogy a profilképeket kör alakú képként ábrázolják, hogy egységesen jelenítsék meg az embereket az alkalmazásokban és a rendszerhéjban. Állítsa a HintCrop tulajdonságot kör alakú értékre a kép kör alakú körülvágással való megjelentetéséhez.

Képernyőkép egy alkalmazásértesítésről, amelyen az alkalmazás embléma képe kör alakra van vágva, és a látvány területének bal oldalán helyezkedik el a bejelentésben. 

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

Fő kép

Évfordulós frissítés újdonságai: Az alkalmazásértesítések megjeleníthetnek egy főképet, amely egy kiemelt ToastGenericHeroImage látható a bejelentési szalagcímen és a Notification Centerben. A kép mérete 364x180 képpont 100% skálázáskor.

Képernyőkép egy alkalmazásértesítésről, amely a fő kép elhelyezését mutatja a hozzárendelési terület felett. 

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

Képméret korlátozásai

A bejelentési értesítésben használt képek forrása...

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

Http- és https távoli webes képek esetén az egyes képek fájlmérete korlátozott. Az 16299-es őszi alkotói frissítésben 3 MB-ra növeltük a korlátot a normál kapcsolatokon, és 1 MB-ot a forgalmi díjas kapcsolatokon. Előtte a képek mindig 200 KB-ra korlátozódtak.

Normál kapcsolat Forgalmi díjas kapcsolat A Fall Creators Update előtt
3 MB 1 MB 200 KB

Ha egy kép túllépi a fájlméretet, vagy nem sikerül letölteni vagy túllépni az időkorlátot, a rendszer elveti a képet, és megjelenik az értesítés többi része.

Hozzárendelés szövege

Évfordulós frissítés új: Ha hivatkoznia kell a tartalom forrására, használhatja a forrásszöveget. Ez a szöveg mindig a szöveges elemek alatt, de a beágyazott képek fölött jelenik meg. A szöveg valamivel kisebb méretet használ, mint a szokásos szövegelemek, hogy segítsen megkülönböztetni őket a normál szövegelemektől.

A Windows régebbi verzióiban, amelyek nem támogatják a forrásszöveget, a szöveg egyszerűen egy másik szövegelemként jelenik meg (feltéve, hogy még nem rendelkezik legfeljebb három szöveges elemsel).

A bejelentési értesítés képernyőképe, amely a bejelentés vizualizációs területén lévő többi szövegsor alatt az 

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

Egyéni időbélyeg

Újdonságok a Creators Update-ben: Mostantól a rendszer által biztosított időbélyeget felülbírálhatja saját időbélyegével, amely pontosan jelzi az üzenet/információ/tartalom létrehozásának idejét. Ez az időbélyeg a Notification Centerben látható.

Képernyőkép egy értesítésről az Értesítési központban egyéni időbélyeggel

Ha szeretne többet megtudni az egyéni időbélyeg használatáról, tekintse meg azértesítéseken található egyéni időbélyegeket.

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

Folyamatjelző sáv

Újdonság a Creators Update-ben: Az alkalmazásértesítésben megjeleníthet egy folyamatjelző sávot, amely tájékoztatja a felhasználót az olyan műveletek előrehaladásáról, mint a letöltések.

Egy toast értesítés képernyőképe, amely egy folyamatjelző sávot mutat.

Ha többet szeretne megtudni a folyamatjelzők használatáról, lásd a Toast progress bar.

Headers

Alkotók új frissítése: Az értesítéseket az Értesítési központ fejlécei alatt csoportosíthatja. Például csoportosíthat üzeneteket egy csoportos csevegésből egy fejléc alá, vagy azonos témájú értesítéseket egy fejléc alá, vagy még többet.

Képernyőkép egy műveletközpontról, amely több értesítést jelenít meg az Alkalmazásértesítések megjelenítőjéről a

Ha többet szeretne megtudni a fejlécek használatáról, tekintse meg Toast fejlécek.

Adaptív tartalom

Évfordulós frissítés újdonságai: A fent megadott tartalom mellett további adaptív tartalmakat is megjeleníthet, amelyek az értesítés kibontásakor láthatók.

Ez a további tartalom az Adaptive használatával van megadva, amelyről az Adaptív csempék dokumentációjának elolvasásával tudhat meg többet.

Vegye figyelembe, hogy az adaptív tartalmakat egy AdaptiveGroupkell tartalmaznia. Különben nem adaptív módon kerül megjelenítésre.

Oszlopok és szövegelemek

Íme egy példa az oszlopok és néhány speciális adaptív szövegelem használatára. Mivel a szövegelemek egy AdaptiveGroup-csoporton belül találhatók, támogatják a gazdag adaptív stílustulajdonságokat.

Egy toast értesítés képernyőképe, amelyen a toast értesítés vizuális területének bal és jobb oldalán lévő szövegelemek csoportjai láthatók. 

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

Buttons

A gombok interaktívvá teszik a pirítósod, lehetőséget nyújtva a felhasználónak arra, hogy gyors műveleteket hajtson végre az alkalmazásértesítéseiddel az aktuális munkafolyamat megszakítása nélkül. A felhasználók például közvetlenül egy bejelentésből válaszolhatnak egy üzenetre, vagy törölhetik az e-maileket anélkül, hogy megnyitnák az e-mail-alkalmazást. A gombok az értesítés kibontott részében jelennek meg.

A gombok végpontok közötti implementálásáról további információt a Helyi értesítés küldésecímű témakörben talál.

A gombok az alábbi módokon aktiválhatnak egy alkalmazást:

  • Az alkalmazás az előtérben aktiválva van egy argumentummal, amely egy adott lapra/környezetre való navigálásra használható.
  • Egy másik alkalmazás protokollindítással aktiválódik.
  • A háttéraktiválás kifejezetten támogatott az UWP-alkalmazások esetében. A Windows App SDK-alkalmazások esetében az alkalmazás mindig az előtérben indul el. Az alkalmazás meghívhatja az AppInstance.GetActivatedEventArgs parancsot , hogy észlelje, hogy az aktiválást egy értesítés indította-e el, és az átadott argumentumokból állapítsa meg, hogy az előtéralkalmazást teljesen el szeretné-e indítani, vagy csak kezelni szeretné az értesítést és a kilépést.
  • Az UWP-alkalmazások és a Windows App SDK egyaránt támogatják a rendszerműveleteket, például az értesítés letiltását vagy elutasítását. Az AppNotificationBuilder API-k nem támogatják ezt a forgatókönyvet, de a Windows App SDK-alkalmazások a Microsoft.Windows.AppNotifications.Builder API-k vagy nyers XML használatával implementálhatják ezt a forgatókönyvet.

Note

Legfeljebb 5 gombot használhat (beleértve a helyi menüelemeket is, amelyeket később tárgyalunk).

Képernyőkép egy értesítésről, amelyen egy sor szöveg, majd egy sor található, ahol két gomb van, amelyeket műveletelemek határoznak meg 

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

Ikonokat tartalmazó gombok

A gombokhoz ikonokat is hozzáadhat. Ezek az ikonok fehér, átlátszó, 16x16 képpontos képek 100% skálázáskor, és magának a képnek nem szabad paddingot tartalmaznia. Ha úgy dönt, hogy ikonokat ad meg egy bejelentési értesítésen, az értesítésben minden gomb ikonját meg kell adnia, mivel az ikongombokká alakítja a gombok stílusát.

Note

Az akadálymentesség érdekében mindenképpen mellékelje az ikon kontrasztos fehér verzióját (fehér hátterek fekete ikonját), hogy amikor a felhasználó bekapcsolja a Kontrasztos fehér módot, az ikon látható legyen. További információért lásd: Nyelvi, méretezési és nagy kontraszttámogatás csempékhez és értesítési üzenetekhez.

Képernyőkép egy ikonokkal ellátott gombokat használó alkalmazásértesítésről. 

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

A Windows 11 Update újdonságai: Elemleírásokat adhat az ikonokhoz az XML HintToolTip tulajdonságával. Ez akkor ideális, ha a gombok ikonokkal rendelkeznek, de nem tartalmaznak tartalmat, mivel így biztosan átadhatja a Windows Narrátor által olvasható szöveget. Ha azonban a tartalom jelen van, akkor a Narrátor felolvassa a tartalmat, függetlenül attól, hogy mit ad át az elemleírás.

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

Gombok színekkel

Windows 11 Updateújdonságai: Piros vagy zöld színeket adhat a gombokhoz, ha hozzáadja a useButtonStyle attribútumot a toast XML-elemhez és a hint-buttonStyle attribútumot a művelet XML-elemhez, az alább látható módon.

A három gombot tartalmazó értesítés képernyőképe, a két bal oldali gomb zöld színű, a videohívás indítására vagy hanghívás indítására szolgáló ikonokkal. A harmadik gomb piros, és egy ikon jelzi a hívás elutasítását. 

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

Helyi menüműveletek

Új az évfordulós frissítésben: Hozzáadhat további helyi menüműveleteket a meglévő helyi menühöz, amely akkor jelenik meg, amikor a felhasználó a jobb gombbal a bejelentési értesítésre kattint, vagy a helyi menü ikonjára kattint.

Note

A régebbi eszközökön ezek a további helyi menüműveletek egyszerűen normál gombként jelennek meg az értesítésben.

A hozzáadott további helyi menüműveletek (például "Csoportos csevegés elnémítása 1 órán keresztül") a két alapértelmezett rendszerbejegyzés felett jelennek meg.

Bejelentés helyi menüvel 

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

További helyzetérzékeny menüelemek hozzájárulnak az 5 gombos teljes korláthoz egy értesítésen.

A további helyi menüelemek aktiválása a pirítósgombokkal azonos módon történik.

Inputs

A bemenetek az alkalmazásértesítés Műveletek régiójában vannak megadva, ami azt jelenti, hogy csak az értesítés kibontásakor láthatók.

Gyors válasz szövegmezője

Ha engedélyezni szeretne egy gyors válasz szövegdobozt (például egy üzenetkezelő alkalmazásban), adjon hozzá egy szövegbevitelt és egy gombot, és hivatkozzon a szövegbeviteli mező azonosítójára, hogy a gomb megjelenjen a beviteli mező mellett. A gomb opcionális ikonjának, ha van ilyen, 32x32 pixeles képnek kell lennie, amelyen nincs kitöltés, a fehér képpontok átlátszóak, és a méretarány 100%.

Képernyőkép egy toast értesítésről, amely tartalmaz egy profilképet és néhány sornyi szöveget. Az értesítésben található egy szövegdoboz a közvetlen gépeléshez, valamint egy gomb a válasz elküldésére. 

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

Bemenetek gombsávtal

Egy (vagy több) bemenettel is rendelkezhet, amely a bemenetek alatt normál gombokkal jelenik meg.

Képernyőkép egy alkalmazásértesítésről, amely egy szövegsort, egy szövegdobozt és egy sort jelenít meg, amelynek két gombja 

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

Kiválasztási bemenet

A szövegdobozok mellett a kijelölési menüt is használhatja.

Képernyőkép egy alkalmazásértesítésről, amely egy szövegsort, egy kijelölési bemenetet a kijelölt elemként az 

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

Egy kijelölési menü és két gomb segítségével létrehozhatunk egy emlékeztető értesítést, amely a rendszer szundítás és elvetés műveleteit használja. Győződjön meg arról, hogy a forgatókönyv "Emlékeztető" értékre van állítva, hogy az értesítés emlékeztetőként viselkedjen.

Egy alkalmazásértesítés képernyőképe az értekezlet időpontját és helyét leíró szövegsorokkal. A kijelölési mezőben a

A Snooze gombot a kijelölési menü bemenetéhez kapcsoljuk a toast gomb SelectionBoxId tulajdonságával.

A Microsoft.Windows.AppNotifications.Builder szintaxis jelenleg nem támogatja a rendszeraktiválást. Ez a forgatókönyv azonban támogatott a Windows App SDK-alkalmazások esetében, és az API-k vagy a nyers XML használatával készíthet értesítéseket erre a Microsoft.Toolkit.Uwp.Notifications forgatókönyvre.

// 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.

A rendszer snooze használata és a műveletek elvetése:

  • Adjon meg egy ToastButtonSnooze vagy ToastButtonDismiss gombot
  • Igény szerint megadhat egy egyéni tartalomsztringet:
  • Ha nem ad meg sztringet, automatikusan honosított sztringeket használunk a "Snooze" és a "Dismiss" kifejezéshez.
  • Ha szükséges, adja meg a SelectionBoxId azonosítót:
  • Ha nem szeretné, hogy a felhasználó sznúzi intervallumot válasszon, és ehelyett csak azt szeretné, hogy az értesítés csak egyszer szundikeljen egy rendszer által meghatározott időintervallumra (amely az operációs rendszeren konzisztens), akkor ne hozzon létre semmilyen <bemeneti> egyáltalán.
  • Ha szundi intervallumokat szeretne kiválasztani: - A szundi műveletben adja meg a(z) SelectionBoxId értéket - Egyeztesse a bemenet azonosítóját a szundi művelet SelectionBoxId értékével - Adja meg a ToastSelectionBoxItemértékét úgy, hogy az egy nem negatív egész szám legyen, ami a szundi intervallumot percekben jelöli.

Audio

Az egyéni hang mindig támogatott a mobilon, és az Asztali Verzió 1511 (build 10586) vagy újabb verzióiban is. Az egyéni hanganyagokra az alábbi útvonalakon lehet hivatkozni:

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

Másik lehetőségként választhat az ms-winsoundeventslistájából, amelyek mindig is támogatottak mindkét platformon.

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

Az alkalmazásértesítések hangsémával kapcsolatos információiért tekintse meg a hangséma lapját . Hogyan küldjön olyan alkalmazásértesítést, amely egyéni hangokat használ, tekintse meg egyéni hangok az értesítéseken.

Scenarios

Ha fontos értesítéseket, riasztásokat, emlékeztetőket és bejövő hívásértesítéseket szeretne létrehozni, egyszerűen használjon egy normál alkalmazásértesítést a hozzá rendelt Forgatókönyv értékkel. A forgatókönyv néhány viselkedést módosít a konzisztens és egységes felhasználói élmény érdekében. Négy lehetséges forgatókönyv érték létezik.

  • Reminder
  • Alarm
  • IncomingCall
  • Urgent

Reminders

Az emlékeztető forgatókönyvben az értesítés a képernyőn marad, amíg a felhasználó nem zárja be vagy nem hajtja végre a műveletet. A Windows Mobile-on az alkalmazásértesítés előre kibontva is megjelenik. A rendszer emlékeztető hangjelzést ad le. Legalább egy gombot meg kell adnia az alkalmazásértesítésen. Ellenkező esetben az értesítés normál értesítésként lesz kezelve.

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

Riasztás

A riasztások ugyanúgy viselkednek, mint az emlékeztetők, de a riasztások emellett hangjelzést is kapnak az alapértelmezett riasztási hanggal. Legalább egy gombot meg kell adnia az alkalmazásértesítésen. Ellenkező esetben az értesítés normál értesítésként lesz kezelve.

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

Bejövő hívások

A bejövő hívásértesítések előre kibontva jelennek meg speciális hívásformátumban, és a felhasználó képernyőjén maradnak, amíg el nem vetik őket. A csengőhang alapértelmezés szerint ismétlődni fog. Windows Mobile-eszközökön teljes képernyős megjelenítést mutatnak.

Bejövő hívás értesítés 

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

Fontos értesítések

Important

Szükséges: A fontos értesítések használatához a Windows Insider Preview 22546-os vagy újabb buildet kell futtatnia.

A fontos értesítések lehetővé teszik, hogy a felhasználók jobban szabályozhatják, hogy az 1. és a harmadik féltől származó alkalmazások milyen magas prioritású alkalmazásértesítéseket küldhetnek nekik (sürgős/fontos), amelyek áttörhetik a Fókuszsegítőt (Ne zavarjanak). Ez az értesítési beállításokban módosítható.

Képernyőkép egy sürgős alkalmazásértesítésről, amelynek felkiáltójele az alkalmazás neve melletti hozzárendelési területen található. A képen a rendszer által kezdeményezett alkalmazásértesítés is látható, amely gombokkal teszi lehetővé a felhasználó számára a sürgős értesítések engedélyezését vagy letiltását az alkalmazásból. 

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

Honosítás és akadálymentesség

Csempéi és alkalmazásértesítései a megjelenítési nyelvre, a képernyő skálázási tényezőjére, a nagy kontrasztra és más futtatási környezetekhez igazított szövegeket és képeket tölthetnek be. További információért lásd: Csempe értesítések és 'toast' (lebegő) értesítések támogatása nyelv, skálázás és nagy kontraszt esetén.

Aktiválás kezelése

Ha tudni szeretné, hogyan kezelheti az alkalmazásaktiválásokat (a pirítósra kattintó felhasználó vagy a pirítós gombjai), tekintse meg Helyi bejelentés küldésecímű témakört.  

  • Last updated on