Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Windows proporciona varias API de notificación en distintas generaciones del SDK. Si busca en línea cómo enviar una notificación y buscar ejemplos conflictivos, esta página le ayudará a elegir la API adecuada para la aplicación.
¿Qué API debo usar?
La respuesta depende del SDK al que se dirige la aplicación:
| Tipo de aplicación | API recomendada | Namespace |
|---|---|---|
| WinUI 3/SDK de Aplicaciones para Windows (nuevas aplicaciones) | AppNotificationManager |
Microsoft.Windows.AppNotifications |
| WPF, WinForms o Win32 sin empaquetar |
AppNotificationManager a través de NuGet |
Microsoft.Windows.AppNotifications |
| UWP (aplicaciones existentes, sin migración planeada) | ToastNotificationManager |
Windows.UI.Notifications |
Importante
La mayoría de las respuestas de Stack Overflow y los tutoriales anteriores usan ToastNotificationManager desde el espacio de nombres Windows.UI.Notifications. Esta es la API de WinRT para UWP. Funciona en aplicaciones para UWP y puede funcionar en algunos escenarios de escritorio, pero no es la ruta recomendada para las nuevas aplicaciones de SDK de Aplicaciones para Windows. Usa AppNotificationManager para el desarrollo nuevo.
Comparación de api de notificaciones
| Feature |
AppNotificationManager (SDK de Aplicaciones para Windows) |
ToastNotificationManager (WinRT) |
|---|---|---|
| Recomendado para | WinUI 3, WPF, WinForms, Win32 sin empaquetar | Plataforma Universal de Windows (UWP) |
| Paquete NuGet | Microsoft.WindowsAppSDK |
Ninguno (bandeja de entrada) |
| Identidad del paquete necesaria | No (obras empaquetadas y sin empaquetar) | Necesario para algunas características |
| Integración de envío |
PushNotificationManager (SDK de Aplicaciones para Windows) |
API de canal WNS (Windows.Networking.PushNotifications) |
| Desarrollo activo | Sí | Solo mantenimiento |
Tipos de notificaciones
Una vez que haya elegido la API correcta, decida cómo se entregará la notificación:
| Tipo | Descripción | Se utiliza cuando |
|---|---|---|
| Notificación de aplicación local | Desencadenado directamente por el código de la aplicación mientras se ejecuta | Quiere alertar al usuario de un evento en la aplicación |
| Scheduled | Establecer una hora futura para que aparezca la notificación | Avisos de calendario, alarmas |
| Notificación (WNS) | Enviado desde el servicio en la nube a través de Windows Push Notification Services | Mensajes de chat, noticias de última hora, actualizaciones en tiempo real |
| Insignia | Superposición pequeña en el icono de la barra de tareas de la aplicación | Recuento no leído, indicador de estado |
Para obtener un desglose completo de los métodos de entrega, consulte Elegir un método de entrega de notificaciones.
Pasos siguientes
¿Estás desarrollando una aplicación con WinUI 3 o SDK de Aplicaciones para Windows?
-
Introducción a las notificaciones de aplicaciones: notificaciones de aplicaciones locales e push mediante
AppNotificationManager - Inicio rápido de notificaciones de aplicaciones
-
Introducción a las notificaciones push — WNS push usando
PushNotificationManager
¿Estás construyendo una aplicación WPF o WinForms?
- Inicio rápido de notificaciones de aplicaciones — las notificaciones locales de sistema funcionan empaquetadas o desempaquetadas
- Inicio rápido de notificaciones push: las notificaciones push de WNS admiten una ruta de acceso verdaderamente desempaquetada limitada, pero el empaquetado (MSIX o empaquetado con ubicación externa) es necesario para la entrega de fondo y la activación COM.
Importante
SDK de Aplicaciones para Windows las notificaciones push requieren una cuenta de Azure y un registro de aplicaciones de Azure AD. Si la aplicación está empaquetada, también debes enviar una solicitud de asignación de nombre de familia de paquetes (PFN) por correo electrónico: permite hasta una semana de tiempo de procesamiento antes del inicio. Consulte el inicio rápido de notificaciones push para obtener los requisitos previos completos.
¿Crear o mantener una aplicación para UWP?
- Enviar una notificación de aplicación local desde aplicaciones para UWP de C++
- Información general de Windows Push Notification Services (WNS)
Migrando una aplicación para UWP a SDK de Aplicaciones para Windows?
Colaborar con nosotros en GitHub
El origen de este contenido se puede encontrar en GitHub, donde también puede crear y revisar problemas y solicitudes de incorporación de cambios. Para más información, consulte nuestra guía para colaboradores.
