ringkasan pemberitahuan Windows

Windows menyediakan beberapa API pemberitahuan di berbagai generasi SDK. Jika Anda mencari secara online cara mengirim pemberitahuan dan menemukan contoh yang bertentangan, halaman ini akan membantu Anda memilih API yang tepat untuk aplikasi Anda.

API mana yang harus saya gunakan?

Jawabannya tergantung pada SDK mana yang ditargetkan aplikasi Anda:

Jenis aplikasi API yang direkomendasikan Namespace
WinUI 3 / SDK Aplikasi Windows (aplikasi baru) AppNotificationManager Microsoft.Windows.AppNotifications
WPF, WinForms, atau Win32 yang tidak dikemas AppNotificationManager melalui NuGet Microsoft.Windows.AppNotifications
UWP (aplikasi yang ada, tidak ada migrasi yang direncanakan) ToastNotificationManager Windows.UI.Notifications

Penting

Sebagian besar jawaban Stack Overflow dan tutorial yang lebih lama menggunakan ToastNotificationManager dari namespace Windows.UI.Notifications. Ini adalah UWP WinRT API. Ini berfungsi di aplikasi UWP dan mungkin berfungsi dalam beberapa skenario desktop, tetapi ini bukan jalur yang direkomendasikan untuk aplikasi SDK Aplikasi Windows baru. Gunakan AppNotificationManager untuk pengembangan baru.

Perbandingan API Notifikasi

Feature AppNotificationManager (SDK Aplikasi Windows) ToastNotificationManager (WinRT)
Disarankan untuk WinUI 3, WPF, WinForms, Win32 tanpa kemasan UWP
Paket NuGet Microsoft.WindowsAppSDK Tidak ada (kotak masuk)
Identitas paket diperlukan (karya dalam kemasan dan tidak dikemas) Diperlukan untuk beberapa fitur
Integrasi pendorongan PushNotificationManager (SDK Aplikasi Windows) API saluran WNS (Windows.Networking.PushNotifications)
Pengembangan aktif Yes Pemeliharaan saja

Jenis notifikasi

Setelah Anda memilih API yang tepat, putuskan bagaimana pemberitahuan Anda akan dikirimkan:

Tipe Deskripsi Gunakan ketika diperlukan
Pemberitahuan aplikasi lokal Dipicu langsung oleh kode aplikasi Anda saat berjalan Anda ingin memperingatkan pengguna peristiwa dalam aplikasi
Scheduled Atur waktu mendatang agar pemberitahuan muncul Pengingat kalender, alarm
Dorong (WNS) Dikirim dari layanan cloud Anda melalui Windows Push Notification Services Pesan obrolan, berita terkini, pembaruan real time
Lencana Overlay kecil pada ikon taskbar aplikasi Jumlah belum dibaca, indikator status

Untuk perincian lengkap metode pengiriman, lihat Memilih metode pengiriman pemberitahuan.

Langkah berikutnya

Membangun aplikasi WinUI 3 atau SDK Aplikasi Windows?

Membangun aplikasi WPF atau WinForms?

  • Mulai cepat pemberitahuan aplikasi — pemberitahuan pop-up lokal berfungsi dalam keadaan terkemas maupun tidak terkemas
  • Panduan singkat pemberitahuan push — push WNS mendukung jalur terbatas yang tidak dikemas, tetapi pengemasan (dengan MSIX atau dengan lokasi eksternal) diperlukan untuk pengiriman di latar belakang dan aktivasi COM.

Penting

SDK Aplikasi Windows pemberitahuan push memerlukan akun Azure dan pendaftaran aplikasi AD Azure. Jika aplikasi Anda dikemas, Anda juga perlu mengirimkan permintaan pemetaan Package Family Name (PFN) melalui email — berikan waktu hingga satu minggu untuk pemrosesan sebelum peluncuran. Lihat panduan memulai cepat pemberitahuan push untuk melihat semua prasyarat.

Membangun atau memelihara aplikasi UWP?

Migrasi aplikasi UWP ke SDK Aplikasi Windows?

  • Last updated on