Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Windows poskytuje několik rozhraní API pro oznámení napříč různými generacemi sdk. Pokud hledáte online, jak odeslat oznámení a najít konfliktní příklady, pomůže vám tato stránka vybrat správné rozhraní API pro vaši aplikaci.
Které rozhraní API mám použít?
Odpověď závisí na tom, jakou sadu SDK vaše aplikace cílí:
| Typ aplikace | Doporučené rozhraní API | Namespace |
|---|---|---|
| WinUI 3 / Windows App SDK (nové aplikace) | AppNotificationManager |
Microsoft.Windows.AppNotifications |
| WPF (Windows Presentation Foundation), WinForms nebo nebalené Win32 |
AppNotificationManager přes NuGet |
Microsoft.Windows.AppNotifications |
| UPW (existující aplikace, žádná migrace se neplánuje) | ToastNotificationManager |
Windows.UI.Notifications |
Důležité
Většina odpovědí na Stack Overflow a starších kurzů používá ToastNotificationManager z jmenného prostoru Windows.UI.Notifications. Toto je UWP WinRT API. Funguje v aplikacích pro UPW a může fungovat v některých desktopových scénářích, ale není to doporučená cesta pro nové aplikace Windows App SDK. Použijte AppNotificationManager pro nový vývoj.
Porovnání rozhraní API pro oznámení
| funkce |
AppNotificationManager (Windows App SDK) |
ToastNotificationManager (WinRT) |
|---|---|---|
| Doporučeno pro: | WinUI 3, WPF (Windows Presentation Foundation), WinForms, rozbalený Win32 | UPW |
| Balíček NuGet | Microsoft.WindowsAppSDK |
Žádné (inbox) |
| Požadovaná identita balíčku | Ne (funguje zabaleno a rozbalené) | Požadováno pro některé funkce |
| Integrace Push oznámení |
PushNotificationManager (Windows App SDK) |
Rozhraní API kanálu WNS (Windows.Networking.PushNotifications) |
| Aktivní vývoj | Ano | Pouze údržba |
Typy oznámení
Jakmile zvolíte správné rozhraní API, rozhodněte se, jak se oznámení doručí:
| Typ | Description | Použít, když |
|---|---|---|
| Oznámení místní aplikace | Aktivace přímo kódem aplikace při spuštění | Chcete upozornit uživatele na událost v aplikaci. |
| Plánováno | Nastavte čas, kdy se má oznámení zobrazit v budoucnu | Připomínky kalendáře, budíky |
| Nabízení (WNS) | Odesílaná z cloudové služby prostřednictvím služby Windows Push Notification Services | Zprávy chatu, nejnovější zprávy, aktualizace v reálném čase |
| Odznak | Malý překryv na ikoně hlavního panelu aplikace | Počet nepřečtených zpráv, indikátor stavu |
Úplný rozpis metod doručení najdete v tématu Volba metody doručení oznámení.
Další kroky
Vytváříte aplikaci pomocí WinUI 3 nebo Windows App SDK?
-
Přehled oznámení aplikací – místní a push oznámení aplikací pomocí
AppNotificationManager - Rychlý start s notifikacemi aplikací
-
Přehled push oznámení – push oznámení WNS s použitím
PushNotificationManager
Vytváříte aplikaci WPF (Windows Presentation Foundation) nebo WinForms?
- Rychlý start s oznámeními aplikací – místní informační zprávy zabalené nebo rozbalené
- Rychlý start notifikací push – Push oznámení WNS podporují omezenou cestu bez balíčku, ale pro doručení na pozadí a aktivaci COM je vyžadováno balení (MSIX nebo zabalení s externím umístěním).
Důležité
Windows App SDK nabízená oznámení vyžadují účet Azure a registraci aplikace Azure AD. Pokud je vaše aplikace zabalená, musíte také e-mailem odeslat žádost o mapování názvu rodiny balíčků (PFN) — počítejte s dobou zpracování až jeden týden před spuštěním. Úplné požadavky najdete v rychlém průvodci pro push oznámení.
Vytváříte nebo udržujete aplikaci pro UPW?
- Odeslání místního oznámení z aplikací UWP v C++
- Přehled služby WNS (Windows Push Notification Services
Migrace aplikace pro UPW do Windows App SDK?
Spolupracujte s námi na GitHubu
Zdroj tohoto obsahu najdete na GitHubu, kde můžete také vytvářet a kontrolovat problémy a žádosti o přijetí změn. Další informace najdete v našem průvodci pro přispěvatele.
Windows developer