Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Windows udostępnia kilka interfejsów API powiadomień w różnych generacjach zestawu SDK. Jeśli szukasz w trybie online sposobu wysyłania powiadomienia i znajdowania przykładów powodujących konflikt, ta strona pomoże Ci wybrać odpowiedni interfejs API dla aplikacji.
Którego interfejsu API należy użyć?
Odpowiedź zależy od tego, który zestaw SDK jest przeznaczony dla twojej aplikacji:
| Typ aplikacji | Zalecany interfejs API | Namespace |
|---|---|---|
| WinUI 3 / Zestaw SDK do aplikacji systemu Windows (nowe aplikacje) | AppNotificationManager |
Microsoft.Windows.AppNotifications |
| WPF, WinForms lub rozpakowany Win32 |
AppNotificationManager za pośrednictwem narzędzia NuGet |
Microsoft.Windows.AppNotifications |
| Platforma UWP (istniejące aplikacje, brak planowanej migracji) | ToastNotificationManager |
Windows.UI.Notifications |
Ważna
Większość odpowiedzi na Stack Overflow i starsze samouczki korzysta z ToastNotificationManager w przestrzeni nazw Windows.UI.Notifications. Jest to interfejs API WinRT platformy UWP. Działa ona w aplikacjach platformy UWP i może działać w niektórych scenariuszach klasycznych, ale nie jest to zalecana ścieżka dla nowych aplikacji Zestaw SDK do aplikacji systemu Windows. Użyj AppNotificationManager do nowych opracowań.
Porównanie interfejsu API powiadomień
| Funkcja |
AppNotificationManager (Zestaw SDK do aplikacji systemu Windows) |
ToastNotificationManager (WinRT) |
|---|---|---|
| Zalecane dla | WinUI 3, WPF, WinForms, nieopakowany Win32 | platforma UWP |
| Pakiet NuGet | Microsoft.WindowsAppSDK |
Brak wiadomości (skrzynka odbiorcza) |
| Wymagana tożsamość pakietu | Nie (działają w stanie zapakowanym i rozpakowanym) | Wymagane dla niektórych funkcji |
| Integracja push |
PushNotificationManager (Zestaw SDK do aplikacji systemu Windows) |
API kanału WNS (Windows.Networking.PushNotifications) |
| Aktywne programowanie | Yes | Tylko konserwacja |
Typy powiadomień
Po wybraniu odpowiedniego interfejsu API zdecyduj, jak powiadomienie zostanie dostarczone:
| Typ | Opis | Użyj, gdy |
|---|---|---|
| Powiadomienie o aplikacji lokalnej | Wyzwalane bezpośrednio przez kod aplikacji podczas uruchamiania | Chcesz powiadomić użytkownika o zdarzeniu w aplikacji |
| Scheduled | Ustawianie przyszłego czasu wyświetlania powiadomienia | Przypomnienia kalendarza, alarmy |
| Powiadomienie push (WNS) | Wysyłane z usługi w chmurze za pośrednictwem Windows Push Notification Services | Wiadomości czatu, aktualności, aktualizacje w czasie rzeczywistym |
| Odznaka | Mała nakładka na ikonę paska zadań aplikacji | Liczba nieprzeczytanych elementów, wskaźnik stanu |
Aby uzyskać pełny podział metod dostarczania, zobacz Wybieranie metody dostarczania powiadomień.
Następne kroki
Czy tworzysz aplikację WinUI 3 lub Zestaw SDK do aplikacji systemu Windows?
-
Omówienie powiadomień aplikacji — powiadomienia lokalne i wypychane przy użyciu polecenia
AppNotificationManager - Powiadomienia aplikacji - szybki start
Omówienie powiadomień wypychanych — wypychanie WNS przy użyciu
Tworzysz aplikację WPF lub WinForms?
- Przewodnik szybkiego startu dla powiadomień aplikacji — lokalne powiadomienia typu „toast” działają zarówno w pakietach, jak i bez pakietów
- Szybki start powiadomień push — wypychanie w WNS obsługuje ograniczoną ścieżkę faktycznie niepakowaną, ale pakowanie (MSIX lub spakowane z lokalizacją zewnętrzną) jest wymagane do dostarczania w tle i aktywacji COM
Ważna
Powiadomienia push Zestaw SDK do aplikacji systemu Windows wymagają konta Azure i rejestracji aplikacji w Azure AD. Jeśli twoja aplikacja jest spakowana, musisz również przesłać żądanie mapowania nazwy rodziny pakietów (PFN) pocztą e-mail — umożliwia maksymalnie jeden tydzień czasu przetwarzania przed uruchomieniem. Zobacz przewodnik szybkiego startu dotyczący powiadomień push, aby uzyskać kompletne wymagania wstępne.
Czy tworzysz lub utrzymujesz aplikację platformy UWP?
- Wysyłanie powiadomienia aplikacji lokalnej z aplikacji platformy UWP w języku C++
- Omówienie usług powiadomień wypychanych w systemie Windows (WNS)
Migracja aplikacji UWP do Zestaw SDK do aplikacji systemu Windows?
Współpracuj z nami w serwisie GitHub
Źródło tej zawartości można znaleźć w witrynie GitHub, gdzie można również tworzyć i przeglądać problemy i żądania ściągnięcia. Więcej informacji znajdziesz w naszym przewodniku dla współtwórców.
