TileUpdater.StartPeriodicUpdateBatch Método

Definición

Espacio de nombres:

Windows.UI.Notifications

Sobrecargas

StartPeriodicUpdateBatch(IIterable<Uri>, PeriodicUpdateRecurrence)

Comienza una serie de actualizaciones con tiempo a las que se enlaza el ciclo del icono al que está enlazado el actualizador. El contenido de la actualización se recupera de una matriz de identificador uniforme de recursos (URI) especificado, la primera actualización que se produce inmediatamente y las actualizaciones posteriores se producen en el intervalo periódico a partir de entonces. Nota: Para usar esta característica, primero debe habilitar la cola de notificaciones del icono llamando a EnableNotificationQueue.

StartPeriodicUpdateBatch(IIterable<Uri>, DateTime, PeriodicUpdateRecurrence)

Comienza una serie de actualizaciones con tiempo a las que se enlaza el ciclo del icono al que está enlazado el actualizador. El contenido de la actualización se recupera de una matriz de identificador uniforme de recursos (URI) especificado con actualizaciones a partir de un momento especificado y las actualizaciones posteriores que se producen en el intervalo periódico a partir de entonces. Nota: Para usar esta característica, primero debe habilitar la cola de notificaciones del icono llamando a EnableNotificationQueue.

StartPeriodicUpdateBatch(IIterable<Uri>, PeriodicUpdateRecurrence)

Comienza una serie de actualizaciones con tiempo a las que se enlaza el ciclo del icono al que está enlazado el actualizador. El contenido de la actualización se recupera de una matriz de identificador uniforme de recursos (URI) especificado, la primera actualización que se produce inmediatamente y las actualizaciones posteriores se producen en el intervalo periódico a partir de entonces.

Nota:

Para usar esta característica, primero debe habilitar la cola de notificaciones del icono llamando a EnableNotificationQueue.

public:
 virtual void StartPeriodicUpdateBatch(IIterable<Uri ^> ^ tileContents, PeriodicUpdateRecurrence requestedInterval) = StartPeriodicUpdateBatch;

/// [Windows.Foundation.Metadata.Overload("StartPeriodicUpdateBatch")]
void StartPeriodicUpdateBatch(IIterable<Uri> const& tileContents, PeriodicUpdateRecurrence const& requestedInterval);

[Windows.Foundation.Metadata.Overload("StartPeriodicUpdateBatch")]
public void StartPeriodicUpdateBatch(IEnumerable<System.Uri> tileContents, PeriodicUpdateRecurrence requestedInterval);

function startPeriodicUpdateBatch(tileContents, requestedInterval)

Public Sub StartPeriodicUpdateBatch (tileContents As IEnumerable(Of Uri), requestedInterval As PeriodicUpdateRecurrence)

Parámetros

tileContents

IIterable<Uri>

IEnumerable<Uri>

Matriz de hasta cinco identificadores uniformes de recursos (URI) a partir de los cuales se recuperará el contenido XML de las actualizaciones del icono de ciclo. Si la matriz contiene más de cinco identificadores uniformes de recursos (URI), se producirá un error en el método.

requestedInterval

PeriodicUpdateRecurrence

Frecuencia con la que se sondea el identificador uniforme de recursos (URI) para el nuevo contenido del icono, después de la actualización inicial en startTime.

Atributos

OverloadAttribute

Comentarios

Uso de la cola de notificaciones con actualizaciones periódicas

Para usar la cola de notificaciones, primero debe habilitarla para el icono con esta línea de código:

Windows.UI.Notifications.TileUpdateManager.createTileUpdaterForApplication().enableNotificationQueue(true);

Esta API solo debe llamarse una vez en la duración de la aplicación, pero no hay ningún daño en llamarla cada vez que se inicia la aplicación.

En el caso de las notificaciones periódicas, se proporciona una dirección URL única para cada notificación. Windows sondea periódicamente cada dirección URL para obtener contenido de notificación actualizado. La carga de contenido devuelta de cada dirección URL debe contener versiones del XML de notificación para todos los tamaños de icono admitidos. Cada dirección URL sondeada también puede devolver opcionalmente su propia hora de expiración única y el valor de etiqueta.

Etiquetado de notificaciones para actualizaciones periódicas

Con la cola de notificaciones habilitada, el icono puede recorrer un máximo de cinco notificaciones en cola. Por lo general, la notificación más antigua se reemplaza en la cola cuando llega una nueva notificación. Sin embargo, se pueden proporcionar notificaciones a una etiqueta para que una nueva notificación con una etiqueta específica reemplace una notificación anterior por la misma etiqueta, independientemente de su lugar en la cola.

Las etiquetas son cadenas opcionales de hasta 16 caracteres que se pueden establecer en una notificación como identificador. Si una nueva notificación llega con la misma etiqueta que una notificación que ya está en la cola, la nueva notificación reemplaza al antiguo en lugar de estar bajo el comportamiento predeterminado de la primera cola de entrada y salida. Esto impide que dos versiones de la misma notificación (una de ellas no actualizadas) estén presentes en la cola al mismo tiempo.

En el caso de las notificaciones periódicas, las etiquetas se proporcionan en el encabezado X-WNS-Tag del mensaje de respuesta HTTP de la notificación, que también incluye el contenido de la notificación. Este mensaje se envía en respuesta a la llamada periódica del sistema al identificador uniforme de recursos (URI) de la notificación. El nombre del encabezado y el valor de etiqueta no distinguen mayúsculas de minúsculas.

A continuación, se muestra un ejemplo:

X-WNS-Tag: stockMSFT

Establecimiento de una hora de expiración para actualizaciones periódicas

Las notificaciones periódicas expiran de forma predeterminada después de tres días. Si el contenido de la notificación tiene una duración útil significativamente diferente( más corta o más larga), debe establecer explícitamente un tiempo de expiración para cada notificación. Esto evita que el contenido obsoleto o irrelevante permanezca en la cola. Esto es especialmente importante si la máquina del usuario pierde la conectividad a Internet durante un largo período de tiempo.

Por ejemplo, durante las operaciones activas, sería aconsejable que una aplicación de acciones establezca la expiración en una notificación de precio de acción en dos veces al de su intervalo de sondeo, como una notificación que expire una hora después de que se envíe si sondea una actualización cada media hora. En el caso de una aplicación de noticias, una expiración de un día para un icono que muestre las noticias diarias principales sería adecuada.

Para las notificaciones periódicas, la hora de expiración se establece en el encabezado X-WNS-Expires del mensaje de respuesta HTTP de la notificación. La hora de expiración se expresa como una fecha HTTP, que usa uno de los formatos que se muestran en estos ejemplos:

• Sun, 06 Nov 1994 08:49:37 GMT
• Domingo, 06-nov-94 08:49:37 GMT
• Sun 6 nov 08:49:37 1994

Para obtener más información sobre el formato de fecha HTTP, vea el documento Parámetros del protocolo World Wide Web Consortium (W3C) 3.

Para obtener un ejemplo de una implementación completa de las notificaciones periódicas usadas junto con la cola de notificaciones, vea Escenario 3 en el ejemplo de notificaciones push y periódicas (archivado).

Consulte también

• StartPeriodicUpdateBatch(IIterable<Uri>, DateTime, PeriodicUpdateRecurrence)
• StartPeriodicUpdate(Uri, DateTime, PeriodicUpdateRecurrence)
• Cómo configurar notificaciones periódicas para iconos
• Directrices y lista de comprobación para las notificaciones periódicas
• Información general sobre las notificaciones de iconos y iconos

StartPeriodicUpdateBatch(IIterable<Uri>, DateTime, PeriodicUpdateRecurrence)

Comienza una serie de actualizaciones con tiempo a las que se enlaza el ciclo del icono al que está enlazado el actualizador. El contenido de la actualización se recupera de una matriz de identificador uniforme de recursos (URI) especificado con actualizaciones a partir de un momento especificado y las actualizaciones posteriores que se producen en el intervalo periódico a partir de entonces.

Nota:

Para usar esta característica, primero debe habilitar la cola de notificaciones del icono llamando a EnableNotificationQueue.

public:
 virtual void StartPeriodicUpdateBatch(IIterable<Uri ^> ^ tileContents, DateTime startTime, PeriodicUpdateRecurrence requestedInterval) = StartPeriodicUpdateBatch;

/// [Windows.Foundation.Metadata.Overload("StartPeriodicUpdateBatchAtTime")]
void StartPeriodicUpdateBatch(IIterable<Uri> const& tileContents, DateTime const& startTime, PeriodicUpdateRecurrence const& requestedInterval);

[Windows.Foundation.Metadata.Overload("StartPeriodicUpdateBatchAtTime")]
public void StartPeriodicUpdateBatch(IEnumerable<System.Uri> tileContents, System.DateTimeOffset startTime, PeriodicUpdateRecurrence requestedInterval);

function startPeriodicUpdateBatch(tileContents, startTime, requestedInterval)

Public Sub StartPeriodicUpdateBatch (tileContents As IEnumerable(Of Uri), startTime As DateTimeOffset, requestedInterval As PeriodicUpdateRecurrence)

Parámetros

tileContents

IIterable<Uri>

IEnumerable<Uri>

Matriz de hasta cinco identificadores uniformes de recursos (URI) a partir de los cuales se recuperará el contenido XML de las actualizaciones del icono de ciclo. Si la matriz contiene más de cinco identificadores uniformes de recursos (URI), se producirá un error en el método.

startTime

DateTime DateTimeOffset

La hora en la que se debe sondear primero el identificador uniforme de recursos (URI) inicial para el nuevo contenido.

requestedInterval

PeriodicUpdateRecurrence

Frecuencia con la que se sondea el identificador uniforme de recursos (URI) para el nuevo contenido del icono, después de la actualización inicial en startTime.

Atributos

OverloadAttribute

Comentarios

Uso de la cola de notificaciones con actualizaciones periódicas

Para usar la cola de notificaciones, primero debe habilitarla para el icono con esta línea de código:

Windows.UI.Notifications.TileUpdateManager.createTileUpdaterForApplication().enableNotificationQueue(true);

Esta API solo debe llamarse una vez en la duración de la aplicación, pero no hay ningún daño en llamarla cada vez que se inicia la aplicación.

En el caso de las notificaciones periódicas, se proporciona una dirección URL única para cada notificación. Windows sondea periódicamente cada dirección URL para obtener contenido de notificación actualizado. La carga de contenido devuelta de cada dirección URL debe contener versiones del XML de notificación para todos los tamaños de icono admitidos. Cada dirección URL sondeada también puede devolver opcionalmente su propia hora de expiración única y el valor de etiqueta.

Etiquetado de notificaciones para actualizaciones periódicas

Con la cola de notificaciones habilitada, el icono puede recorrer un máximo de cinco notificaciones en cola. Por lo general, la notificación más antigua se reemplaza en la cola cuando llega una nueva notificación. Sin embargo, se pueden proporcionar notificaciones a una etiqueta para que una nueva notificación con una etiqueta específica reemplace una notificación anterior por la misma etiqueta, independientemente de su lugar en la cola.

Las etiquetas son cadenas opcionales de hasta 16 caracteres que se pueden establecer en una notificación como identificador. Si una nueva notificación llega con la misma etiqueta que una notificación que ya está en la cola, la nueva notificación reemplaza al antiguo en lugar de estar bajo el comportamiento predeterminado de la primera cola de entrada y salida. Esto impide que dos versiones de la misma notificación (una de ellas no actualizadas) estén presentes en la cola al mismo tiempo.

En el caso de las notificaciones periódicas, las etiquetas se proporcionan en el encabezado X-WNS-Tag del mensaje de respuesta HTTP de la notificación, que también incluye el contenido de la notificación. Este mensaje se envía en respuesta a la llamada periódica del sistema al identificador uniforme de recursos (URI) de la notificación. El nombre del encabezado y el valor de etiqueta no distinguen mayúsculas de minúsculas.

A continuación, se muestra un ejemplo:

X-WNS-Tag: stockMSFT

Establecimiento de una hora de expiración para actualizaciones periódicas

Los iconos expiran de forma predeterminada después de tres días. Si el contenido de la notificación tiene una duración útil significativamente diferente( más corta o más larga), debe establecer explícitamente un tiempo de expiración para cada notificación. Esto evita que el contenido obsoleto o irrelevante permanezca en la cola. Esto es especialmente importante si la máquina del usuario pierde la conectividad a Internet durante un largo período de tiempo.

Por ejemplo, durante las operaciones activas, sería aconsejable que una aplicación de acciones establezca la expiración en una notificación de precio de acción en dos veces al de su intervalo de sondeo, como una notificación que expire una hora después de que se envíe si sondea una actualización cada media hora. En el caso de una aplicación de noticias, una expiración de un día para un icono que muestre las noticias diarias principales sería adecuada.

Para las notificaciones periódicas, la hora de expiración se establece en el encabezado X-WNS-Expires del mensaje de respuesta HTTP de la notificación. La hora de expiración se expresa como una fecha HTTP, que usa uno de los formatos que se muestran en estos ejemplos:

• Sun, 06 Nov 1994 08:49:37 GMT
• Domingo, 06-nov-94 08:49:37 GMT
• Sun 6 nov 08:49:37 1994

Para obtener más información sobre el formato de fecha HTTP, vea el documento Parámetros del protocolo World Wide Web Consortium (W3C) 3.

Para obtener un ejemplo de una implementación completa de las notificaciones periódicas usadas junto con la cola de notificaciones, vea Escenario 3 en el ejemplo de notificaciones push y periódicas (archivado).

Consulte también

• StartPeriodicUpdateBatch(IIterable<Uri>, PeriodicUpdateRecurrence)
• StartPeriodicUpdate(Uri, DateTime, PeriodicUpdateRecurrence)
• Cómo configurar notificaciones periódicas para iconos
• Directrices y lista de comprobación para las notificaciones periódicas
• Información general sobre las notificaciones de iconos y iconos