Inicio rápido: configurar notificaciones periódicas (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 Inicio rápido: configurar notificaciones periódicas (XAML).

En este tema se muestra cómo iniciar un sondeo periódico de una dirección URL para obtener contenido actualizado para el icono de la aplicación.

Te recomendamos que todas las notificaciones sondeadas usen el encabezado de respuesta HTTP X-WNS-Expires para establecer una hora de expiración explícita. Para más información sobre cómo establecer X-WNS-Expires, consulta TileUpdater.StartPeriodicUpdate o TileUpdater.StartPeriodicUpdateBatch.

Nota En este inicio rápido, manipularás el contenido de la notificación directamente a través del Document Object Model (DOM) XML. Un enfoque opcional se encuentra disponible a través de la biblioteca NotificationsExtensions, que presenta el contenido XML como propiedades de objeto, incluido IntelliSense. Para obtener más información, consulta Inicio rápido: usar la biblioteca NotificationsExtensions en el código. Para ver el código de este inicio rápido expresado mediante NotificationsExtensions, consulta la muestra de notificaciones periódicas y de inserción.

Requisitos previos

Información de trabajo sobre los términos y conceptos de iconos y notificaciones. Si quieres obtener más información, consulta el tema sobre iconos, notificaciones y notificaciones del sistema.
Conocimientos sobre los conceptos de la notificación (de sondeo) periódica. Si quieres obtener más información, consulta el tema de información general sobre notificaciones periódicas.
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.
Un servicio web para hospedar el contenido de la notificación de icono.

Instrucciones

1. Crea o identifica un servicio web para hospedar el contenido XML del icono

Con un intervalo especificado, Windows realizará un sondeo del servicio web especificado en busca de contenidos actualizados del icono para la aplicación. El servicio web debe ser compatible con HTTP. Para pruebas, también puedes configurar un servicio web, tal como Microsoft Internet Information Services (IIS) en el equipo local para probar el XML.

2. Coloca el archivo XML del contenido del icono en una ubicación accesible desde la web

El servicio web hospedará el contenido XML del icono. Para comenzar, hospeda el icono XML que se muestra aquí en el sitio web. Guarda el contenido como un archivo llamado Tile.xml y coloca el archivo en el servidor en una ubicación accesible desde la web (por ejemplo, http://www.fabrikam.com/tile.xml). Los contenidos del documento XML deben usar una codificación UTF-8 y cumplir con el esquema del icono. Debes actualizar el XML al menos con la misma frecuencia que la de los intervalos de periodicidad especificados del sondeo.


<tile>
  <visual version="2">
    <binding template="TileSquare150x150Text04" fallback="TileSquareText04">
      <text id="1">Hello world!</text>
    </binding>  
  </visual>
</tile>

3. Iniciar las actualizaciones periódicas (una sola dirección URL)

En este ejemplo, se muestra cómo comenzar un sondeo de una sola dirección URL para proporcionar nuevo contenido para el icono una vez por hora. Este código usa una variable definida previamente llamada polledUrl, que es una cadena que especifica la dirección URL en la cual se realizará el sondeo.


var notifications = Windows.UI.Notifications;
var recurrence = notifications.PeriodicUpdateRecurrence.hour;
var url = new Windows.Foundation.Uri(polledUrl);

notifications.TileUpdateManager.createTileUpdaterForApplication().startPeriodicUpdate(url, recurrence);

4. Iniciar las actualizaciones periódicas (varias direcciones URL)

Como alternativa al paso anterior, Windows puede sondear hasta cinco direcciones URL diferentes para suministrar un conjunto de contenido que recorra la cola de notificaciones del icono cíclicamente.

En este ejemplo, se muestra cómo sondear varias direcciones URL en busca de nuevo contenido una vez por hora. Primero debes habilitar la cola de notificaciones si aún no lo has hecho. Ten en cuenta que la llamada a enableNotificationQueue solo debe realizarse una vez después de que el usuario instala la aplicación o crea un icono secundario. Este código de ejemplo usa una variable definida previamente llamada urisToPoll, que es una matriz de objetos Windows.Foundation.Uri.

Nota Las actualizaciones de icono periódicas admiten la etiqueta de notificación de icono que forma parte de la lógica de reemplazo de la cola de notificaciones. El servicio puede establecer la etiqueta en cada notificación proporcionando el encabezado de respuesta HTTP X-WNS-Tag. Para más información sobre el uso de etiquetas y la cola de notificaciones, consulta el tema sobre cómo usar la cola de notificaciones con notificaciones locales. Para obtener más información sobre el uso del encabezado de respuesta HTTP X-WNS-Tag con notificaciones periódicas, consulta TileUpdater.startPeriodicUpdateBatch.


var notifications = Windows.UI.Notifications;                        
var recurrence = notifications.PeriodicUpdateRecurrence.hour;

notifications.TileUpdateManager.createTileUpdaterForApplication().enableNotificationQueue(true);

notifications.TileUpdateManager.createTileUpdaterForApplication().startPeriodicUpdateBatch(urisToPoll, recurrence);