Cómo programar una notificación del sistema (HTML)

Artículo
12/12/2015

[ Este artículo está destinado a desarrolladores de Windows 8.x y Windows Phone 8.x que escriben aplicaciones de Windows en tiempo de ejecución. Si estás desarrollando para Windows 10, consulta la documentación más reciente

Nota ¿No usas JavaScript? Consulta Cómo programar una notificación del sistema (XAML).

En este tema se muestra cómo programar una notificación del sistema para que aparezca a una hora específica.

Lo que debes saber

Tecnologías

Windows Runtime

Requisitos previos

Conocimientos prácticos sobre los términos y conceptos relacionados con las notificaciones del sistema. Para más información, consulta el tema de introducción a las notificaciones del sistema.
Capacidad para crear una aplicación de la Tienda Windows con JavaScript básica mediante las API de Windows en tiempo de ejecución. Para obtener más información, consulta el tema sobre cómo crear tu primera aplicación de la Tienda Windows con JavaScript.
La opción de compatibilidad con notificaciones del sistema debe habilitarse en el manifiesto de la aplicación para poder enviar o recibir notificaciones del sistema. Para obtener más información, consulta el tema sobre el procedimiento para elegir recibir notificaciones del sistema.

Instrucciones

Paso 1: Especifica una plantilla

Antes de que puedas especificar la hora de entrega, debes crear la notificación.


var template = Windows.UI.Notifications.ToastTemplateType.toastText02;                        
var toastXml = Windows.UI.Notifications.ToastNotificationManager.getTemplateContent(template);

Paso 2: Proporcionar contenido para una notificación del sistema

No abordamos este tema aquí porque el procedimiento es el mismo para una notificación del sistema programada que para una no programada. Para más información, consulta el tema de inicio rápido: envío de una notificación del sistema.

Paso 3: Especifica a qué hora debería entregarse la notificación de sistema

En este ejemplo, se especifica que la notificación debería aparecer en 3 segundos. En este ejemplo, se usa el objeto de JavaScript Date para recuperar la hora actual.


var currentTime = new Date();
var startTime = new Date(currentTime.getTime() + 3 * 1000);

Paso 4: Crea el objeto de notificación del sistema programada

Envía el contenido de la notificación del sistema y la hora de entrega programada al constructor.

var scheduledToast = new Windows.UI.Notifications.ScheduledToastNotification(toastXml, startTime);

Paso 5: Opcional: asignar un identificador a la notificación del sistema programada

Este identificador debe tener 16 caracteres o menos. Se puede usar más adelante si quieres cancelar la notificación.

scheduledToast.id = "Future_Toast";

Paso 6: Agrega la notificación del sistema a la programación.

Crea el objeto ToastNotifier, que a su vez se usa para agregar la notificación a la programación.


var toastNotifier = Windows.UI.Notifications.ToastNotificationManager.createToastNotifier();
toastNotifier.addToSchedule(scheduledToast);

Incorporación de una notificación del sistema que se repite a intervalos específicos

El siguiente código muestra una sola notificación del sistema cinco veces, separadas por un minuto de tiempo entre sí. Para mayor claridad, se ha omitido el código para rellenar la plantilla.


var template = Windows.UI.Notifications.ToastTemplateType.toastText02;
var toastXml = Windows.UI.Notifications.ToastNotificationManager.getTemplateContent(template);

// TO DO: Fill in the template with your notification content here. 
 
var currentTime = new Date();
var startTime = new Date(currentTime.getTime() + 1000);
 
var recurringToast = new Windows.UI.Notifications.ScheduledToastNotification(toastXml, startTime, 60 * 1000, 5);
recurringToast.id = "Recurring_Toast";

var toastNotifier = Windows.UI.Notifications.ToastNotificationManager.createToastNotifier();
toastNotifier.addToSchedule(recurringToast);