Aplicaciones de Windows
Contraer la tabla de contenido
Expandir la tabla de contenido

Cómo ejecutar una tarea en segundo plano en un temporizador (aplicaciones de la Tienda Windows con JavaScript y HTML)

Aprende cómo programar una tarea en segundo plano única o ejecutar una tarea en segundo plano periódica asociada con tu aplicación de la Tienda Windows. Si el usuario coloca tu aplicación en la pantalla de bloqueo, la aplicación podrá registrar una tarea en segundo plano que se ejecute hasta cada 15 minutos. Por ejemplo, una tarea en segundo plano podría usarse para proporcionar actualizaciones de distintivos e iconos periódicas.

Lo que debes saber

Tecnologías

Requisitos previos

Instrucciones

Paso 1: Crear un desencadenador de hora

Crea un nuevo TimeTrigger. El segundo parámetro, OneShot, especifica si la tarea en segundo plano se ejecutará una vez o si seguirá ejecutándose periódicamente. Si OneShot se establece en true, el primer parámetro (FreshnessTime) especifica el número de minutos que deben esperarse antes de programar la tarea en segundo plano. Si OneShot se establece en false, FreshnessTime especifica la frecuencia con la que se ejecutará la tarea en segundo plano.

Windows 8 tiene un temporizador integrado que ejecuta tareas en segundo plano en intervalos de 15 minutos.

  • Si FreshnessTime se establece en 15 minutos y OneShot tiene el valor true, la tarea se ejecutará una vez comenzando entre el minuto 0 y el 15 desde el momento en que se registre.

  • Si FreshnessTime se establece en 15 minutos y OneShot tiene el valor false, la tarea se ejecutará cada 15 minutos comenzando entre el minuto 0 y el 15 desde el momento en que se registre.

Nota  Si FreshnessTime se establece en menos de 15 minutos, se iniciará una excepción cuando se intente registrar una tarea en segundo plano.

Por ejemplo, este desencadenador hará que una tarea en segundo plano se ejecute una vez cada hora:


var hourlyTrigger = new Windows.ApplicationModel.Background.TimeTrigger(60, false);

Paso 2: (Opcional) Agregar una condición

Si es necesario, agrega una condición a la tarea en segundo plano para controlar cuándo la tarea debe ejecutarse. Una condición evita que tu tarea en segundo plano se ejecute hasta que no se satisfaga la condición; para obtener más información, consulta Cómo establecer condiciones para ejecutar una tarea en segundo plano.

En este ejemplo, la condición se establece en UserPresent de forma que, al desencadenarse, la tarea solo se ejecuta cuando el usuario esté activo. Para obtener una lista de posibles condiciones, consulta SystemConditionType.

El siguiente código agrega una condición a la tarea en segundo plano:


var userCondition = new Windows.ApplicationModel.Background.SystemCondition(Windows.ApplicationModel.Background.SystemConditionType.UserPresent);


Paso 3: Solicitar acceso a la pantalla de bloqueo

Antes de intentar registrar la tarea en segundo plano TimeTrigger, solicita permiso del usuario para agregarla a la pantalla de bloqueo llamando a RequestAccessAsync.

El siguiente código presenta una cuadro de diálogo al usuario solicitándole agregar tu aplicación a la pantalla de bloqueo:


Windows.ApplicationModel.Background.BackgroundExecutionManager.RequestAccessAsync();

Nota  Una aplicación puede solicitar acceso a la pantalla de bloqueo solamente una vez. El usuario puede elegir solo una de las dos opciones y se establecerá su preferencia. Las llamadas posteriores a RequestAccessAsync no se tendrán en cuenta.

Paso 4: Registrar la tarea en segundo plano

Registra la tarea en segundo plano llamando a tu función de registro de tareas en segundo plano. Para obtener más información acerca del registro de tareas en segundo plano, consulta Cómo registrar una tarea en segundo plano.

El siguiente código registra la tarea en segundo plano:


var entryPoint = “js\\ExampleBackgroundTask.js”;
var taskName = “Example hourly background task”;

var task = RegisterBackgroundTask(entryPoint, taskName, hourlyTrigger, userCondition);

Observaciones

Nota  Las tareas en segundo plano solo se registrarán con un desencadenador de hora si el usuario ha agregado tu aplicación a la pantalla de bloqueo; consulta Visualización de iconos en la pantalla de bloqueo.

Nota  Las tareas en segundo plano pueden asociarse con desencadenadores que no requieren que la aplicación esté en la pantalla de bloqueo. Para obtener una guía sobre estos tipos de desencadenadores de tarea en segundo plano, consulta Dar soporte a tu aplicación mediante tareas en segundo plano.

Temas relacionados

Inicio rápido: creación y registro de una tarea en segundo plano
Cómo registrar una tarea en segundo plano
Cómo declarar tareas en segundo plano en el manifiesto de la aplicación
How to debug a background task
Directrices y listas de comprobación para tareas en segundo plano

 

 

Mostrar:
© 2018 Microsoft