Inicio rápido: configurar notificaciones periódicas (HTML)

  • Artículo

[ 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

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);

Resumen y siguientes pasos

Este inicio rápido te guió a través de la configuración de una notificación de icono periódica.La misma técnica se puede usar en los distintivos.

Temas relacionados

Muestra de notificaciones periódicas y de inserción

Directrices para notificaciones periódicas

Cómo usar la cola de notificaciones con notificaciones locales