Compartir a través de


Windows.ApplicationModel.Background Espacio de nombres

Permite a una aplicación programar tareas en segundo plano para ejecutar código de aplicación incluso cuando la aplicación está suspendida.

Las tareas en segundo plano están diseñadas para elementos de trabajo pequeños que no requieren interacción del usuario ni para controlar las acciones del sistema. Los escenarios adecuados para las tareas en segundo plano incluyen descargar correo, mostrar una notificación del sistema para un mensaje de chat entrante o reaccionar ante un cambio en una condición del sistema.

Consulta Compatibilidad de la aplicación con tareas en segundo plano ( con JavaScript y HTML) o Compatibilidad con la aplicación con tareas en segundo plano para obtener instrucciones sobre cómo implementar tareas en segundo plano. Para obtener código de ejemplo que muestra cómo implementar tareas en segundo plano, vea ejemplo de tarea en segundo plano.

Clases

ActivitySensorTrigger

Representa un desencadenador que se activa cuando ActivitySensor recibe la entrada. Esto se usa cuando la aplicación necesita responder al sensor de actividad.

AlarmApplicationManager

Solicita permiso al usuario para establecer alarmas y recupera el estado del permiso de usuario para que la aplicación establezca alarmas.

AppBroadcastTrigger

Representa un evento que desencadena una tarea en segundo plano para ejecutarse cuando una aplicación inicia la difusión del juego.

AppBroadcastTriggerProviderInfo

Proporciona información sobre la aplicación que está difundiendo el juego, como su logotipo, nombre para mostrar y características de vídeo.

ApplicationTrigger

Esto le permite desencadenar mediante programación una tarea en segundo plano desde dentro de la aplicación.

ApplicationTriggerDetails

Detalles de applicationTrigger.

AppointmentStoreNotificationTrigger

Representa un desencadenador que inicia una tarea en segundo plano para procesar los cambios en el almacén de citas.

BackgroundExecutionManager

Administrar el permiso para ejecutar tareas en segundo plano.

BackgroundTaskBuilder

Representa una tarea en segundo plano para registrarse en el sistema.

BackgroundTaskCompletedEventArgs

Representa la información de finalización de una tarea en el momento en que se envía una notificación de finalización.

BackgroundTaskDeferral

Representa un aplazamiento de tareas en segundo plano devuelto por el método IBackgroundTaskInstance.GetDeferral .

BackgroundTaskProgressEventArgs

Representa la información de progreso de una tarea en el momento en que se envía una notificación de actualización de progreso.

BackgroundTaskRegistration

Representa una tarea en segundo plano que se ha registrado en el sistema.

BackgroundTaskRegistrationGroup

Proporciona semántica de agrupación para que el registro de tareas en segundo plano se pueda mantener por separado.

BackgroundWorkCost

Recupera una sugerencia sobre la disponibilidad de recursos para las tareas en segundo plano. Las tareas en segundo plano pueden usar esta sugerencia para decidir cuánto trabajo hacer cuando se activan.

BluetoothLEAdvertisementPublisherTrigger

Representa un desencadenador registrado para anunciar un anuncio bluetooth LE en segundo plano.

BluetoothLEAdvertisementWatcherTrigger

Representa un desencadenador que está registrado para examinar el anuncio de Bluetooth LE en segundo plano.

CachedFileUpdaterTrigger

Representa un desencadenador que inicia una tarea en segundo plano para habilitar el contrato del actualizador de archivos almacenados en caché.

CachedFileUpdaterTriggerDetails

Proporciona detalles sobre la operación de archivo almacenada en caché que invocó el desencadenador.

ChatMessageNotificationTrigger

Representa un desencadenador que se activa cuando hay una notificación para un mensaje de texto.

ChatMessageReceivedNotificationTrigger

Representa un desencadenador que inicia una tarea en segundo plano que controla cualquier mensaje entrante que pueda necesitar filtrarse según su contenido. Para obtener más información sobre el filtrado de mensajes, vea Windows.ApplicationModel.CommunicationBlocking.

CommunicationBlockingAppSetAsActiveTrigger

Representa un desencadenador para activar una aplicación de bloqueo de comunicación cuando se selecciona como aplicación de bloqueo preferida.

Un usuario puede tener varias aplicaciones de bloqueo de comunicación instaladas al mismo tiempo. Este desencadenador se usa para informar a una aplicación de que se ha seleccionado como aplicación de bloqueo de comunicación activa. Para obtener más información sobre la API de bloqueo de comunicaciones, vea Windows.ApplicationModel.CommunicationBlocking.

ContactStoreNotificationTrigger

Representa un desencadenador que inicia una tarea en segundo plano para procesar los cambios en el almacén de contactos.

ContentPrefetchTrigger

Proporciona la capacidad de ejecutar controladores personalizados al capturar previamente recursos web.

ConversationalAgentTrigger

Representa un desencadenador que inicia una tarea en segundo plano para procesar la comunicación digital asistente a través del entorno de ejecución de activación del agente de la plataforma Windows (AAR).

CustomSystemEventTrigger

Esta clase permite especificar un desencadenador del sistema personalizado para que pueda registrarlo y responder cuando el sistema lo desencadene.

DeviceConnectionChangeTrigger

Representa un desencadenador que inicia una tarea en segundo plano cuando cambia el estado de conexión de un dispositivo.

DeviceManufacturerNotificationTrigger

Representa un desencadenador que inicia una tarea en segundo plano para habilitar las operaciones del fabricante del dispositivo.

DeviceServicingTrigger

Representa un evento que una aplicación puede desencadenar para iniciar una actualización de ejecución prolongada (firmware o configuración) de un dispositivo.

Windows 8.1 permite desarrollar aplicaciones para UWP para los dispositivos periféricos que se comunican a través de USB, HID y Bluetooth. Por ejemplo, un usuario podría necesitar sincronizar contenido en un equipo con o desde el dispositivo, o realizar una actualización de ejecución prolongada en el propio dispositivo, como la configuración o las actualizaciones de firmware. Windows 8.1 proporciona dos tareas en segundo plano y las API correspondientes que permiten que el dispositivo se sincronice y actualice en segundo plano: DeviceServicingTrigger y DeviceUseTrigger. En este tema se proporciona información de referencia de API para DeviceServicingTrigger: para obtener información sobre el uso de este desencadenador en el contexto de una aplicación de dispositivo, consulta Sincronización y actualización de dispositivos para aplicaciones de dispositivo para UWP.

La tarea en segundo plano DeviceServicingTrigger permite que la aplicación para UWP interactúe con el dispositivo periférico para realizar actualizaciones de dispositivos de larga duración mientras la aplicación está suspendida, por ejemplo, las transferencias de configuración o las actualizaciones de firmware. La actualización del dispositivo en segundo plano requiere la aprobación del usuario cada vez que se usa la tarea en segundo plano. A diferencia de la tarea en segundo plano DeviceUseTrigger , la tarea en segundo plano DeviceServicingTrigger permite reiniciar y desconectar el dispositivo y permite un máximo de 30 minutos de actividad en segundo plano.

Importante

Este desencadenador no se puede usar con tareas en segundo plano de proceso único.

DeviceUseTrigger

Representa un evento que una aplicación de Windows Runtime puede desencadenar para iniciar una operación de ejecución prolongada con un dispositivo o sensor.

DeviceUseTrigger permite a la aplicación Windows Runtime acceder a sensores y dispositivos periféricos en segundo plano, incluso cuando se suspende la aplicación en primer plano. Por ejemplo, en función de dónde se ejecute la aplicación, podrías usar una tarea en segundo plano para sincronizar datos con dispositivos o sensores de monitores.

Esta clase se puede usar en la aplicación para UWP y Windows Phone aplicación 8.x. Sin embargo, una tarea en segundo plano deviceUseTrigger admite diferentes API y está sujeta a directivas diferentes, en función de dónde se ejecute (PC o teléfono). Para más información sobre estas diferencias, consulte Acceso a sensores y dispositivos desde una tarea en segundo plano.

Importante

Este desencadenador no se puede usar con tareas en segundo plano de proceso único.

Para obtener un ejemplo que muestra cómo usar DeviceUseTrigger en un equipo, consulta el ejemplo de dispositivo USB personalizado. Para obtener un ejemplo de teléfono, consulte el ejemplo De sensores en segundo plano.

DeviceWatcherTrigger

Representa un evento que hace que se ejecute una tarea en segundo plano cuando se produzcan cambios en la lista de dispositivos. Devuelto por GetBackgroundTrigger.

EmailStoreNotificationTrigger

Representa un desencadenador que habilita la notificación de cambios en el almacén de correo electrónico.

GattCharacteristicNotificationTrigger

Representa un desencadenador que inicia una tarea en segundo plano cuando se recibe una notificación de cambio entrante para una característica GATT de Bluetooth LE.

GattServiceProviderTrigger

Construye un servicio de atributos genéricos (GATT) que se puede conservar en segundo plano.

GattServiceProviderTriggerResult

Esta clase contiene el desencadenador creado por GattServiceProviderTrigger.CreateAsync().

GeovisitTrigger

Representa un evento que desencadena una tarea en segundo plano relacionada con visitas.

LocationTrigger

Representa un evento de ubicación que desencadena una tarea en segundo plano. Se usa para geovalla.

MaintenanceTrigger

Representa un desencadenador de mantenimiento.

MediaProcessingTrigger

Representa un desencadenador que inicia una tarea en segundo plano para realizar el procesamiento multimedia.

MobileBroadbandDeviceServiceNotificationTrigger

Representa un desencadenador que se activa cuando la red envía comandos de la herramienta SIM. Las aplicaciones que reciben esta notificación procesan los comandos de la herramienta SIM.

Esta funcionalidad solo está disponible para las aplicaciones de operador de telefonía móvil y la aplicación para UWP con acceso con privilegios por parte de los operadores de red móvil. Para obtener más información, consulte Banda ancha móvil.

MobileBroadbandPcoDataChangeTrigger

Representa un evento de cambio de opción de configuración del protocolo de telefonía móvil que desencadena una tarea en segundo plano para ejecutarse.

MobileBroadbandPinLockStateChangeTrigger

Representa un desencadenador que indica cuándo ha cambiado el estado de bloqueo del PIN sim.

Esta funcionalidad solo está disponible para las aplicaciones de operador de telefonía móvil y la aplicación para UWP con acceso con privilegios por parte de los operadores de red móvil. Para obtener más información, consulte Banda ancha móvil.

MobileBroadbandRadioStateChangeTrigger

Representa un desencadenador que indica cuándo ha cambiado el estado de radio de banda ancha móvil. Por ejemplo, este desencadenador se activa cuando un dispositivo móvil pasa a o desde el modo avión.

Esta funcionalidad solo está disponible para las aplicaciones de operador de telefonía móvil y la aplicación para UWP con acceso con privilegios por parte de los operadores de red móvil. Para obtener más información, consulte Banda ancha móvil.

MobileBroadbandRegistrationStateChangeTrigger

Representa un desencadenador que indica cuándo ha cambiado el estado de registro de banda ancha móvil. Por ejemplo, este desencadenador se activa cuando un dispositivo móvil realiza la transición hacia o desde Roaming.

Esta funcionalidad solo está disponible para las aplicaciones de operador de telefonía móvil y la aplicación para UWP con acceso con privilegios por parte de los operadores de red móvil. Para obtener más información, consulte Banda ancha móvil.

NetworkOperatorDataUsageTrigger

Representa un desencadenador que inicia una tarea en segundo plano cuando los contadores de datos locales calculan que el uso (bytes enviados y recibidos) en la interfaz de banda ancha móvil ha cambiado por un umbral accionable.

Nota:

Esta funcionalidad solo está disponible para las aplicaciones de operador de telefonía móvil y las aplicaciones para UWP con acceso con privilegios por parte de los operadores de red móvil.

Si quieres usar esta API y publicar tu aplicación en Microsoft Store, necesitarás aprobación especial. Para obtener más información, consulte la sección Funcionalidades restringidas del tema Declaraciones de funcionalidad de la aplicación y Banda ancha móvil.

NetworkOperatorHotspotAuthenticationTrigger

Representa un desencadenador de autenticación de zona activa del operador de red móvil.

Nota:

Una aplicación solo puede crear una instancia de este objeto y registrarse para el evento de autenticación del punto de acceso después de aprovisionar un perfil WLAN que haga referencia a esta aplicación para controlar la autenticación del punto de acceso. Para obtener más información, consulta Integración de Windows 8 para operadores de puntos de acceso inalámbricos.

NetworkOperatorNotificationTrigger

Representa un desencadenador de notificación de operador de red móvil.

PaymentAppCanMakePaymentTrigger

Esta clase representa un desencadenador PaymentAppCanMakePayment.

PhoneTrigger

Representa un evento telefónico que desencadena una tarea en segundo plano.

PushNotificationTrigger

Representa un objeto que invoca un elemento de trabajo en segundo plano en la aplicación en respuesta a la recepción de una notificación sin procesar.

RcsEndUserMessageAvailableTrigger

Representa un desencadenador que inicia una tarea en segundo plano cuando hay disponible un nuevo mensaje de Rich Communication Services (RCS).

RfcommConnectionTrigger

Representa un desencadenador que inicia una tarea en segundo plano cuando se establecen conexiones entrantes o salientes de RFCOMM.

SecondaryAuthenticationFactorAuthenticationTrigger

Representa un desencadenador que inicia una tarea en segundo plano en nombre de un dispositivo complementario.

SensorDataThresholdTrigger

Representa un desencadenador que responde cuando se cruza un límite de umbral para un sensor.

SmartCardTrigger

Representa un evento desencadenado por una tarjeta inteligente.

SmsMessageReceivedTrigger

Representa un desencadenador que se genera cuando ha llegado un mensaje SMS.

SocketActivityTrigger

Representa un desencadenador que inicia una tarea en segundo plano para controlar la actividad de socket.

StorageLibraryChangeTrackerTrigger

Representa un cambio de archivo dentro de una clase StorageFolder que desencadena una tarea en segundo plano que se va a ejecutar.

StorageLibraryContentChangedTrigger

Crea un desencadenador que se activará cuando se cambie un archivo en una biblioteca especificada.

SystemCondition

Representa una condición del sistema que debe estar en vigor para que se ejecute una tarea en segundo plano.

SystemTrigger

Representa un evento del sistema que desencadena la ejecución de una tarea en segundo plano.

TetheringEntitlementCheckTrigger

Representa un evento de tethering que desencadena una tarea en segundo plano que se va a ejecutar.

TimeTrigger

Representa un evento de hora que desencadena una tarea en segundo plano que se va a ejecutar.

ToastNotificationActionTrigger

Representa un evento que hace que se ejecute una tarea en segundo plano cuando el usuario realiza una acción en una notificación del sistema interactiva.

ToastNotificationHistoryChangedTrigger

Representa un evento que hace que se ejecute una tarea en segundo plano cuando se borra el historial de notificaciones del sistema de la aplicación, cuando se agregan o quitan una o varias notificaciones del sistema del historial de notificaciones de la aplicación, o cuando una o varias notificaciones del sistema para la aplicación expiran y se quitan del historial de notificaciones.

UserNotificationChangedTrigger

Representa un desencadenador que se activa cuando se agrega o quita un UserNotification .

WiFiOnDemandHotspotConnectTrigger

Representa un evento que hace que una tarea en segundo plano se ejecute cuando el usuario desea conectarse a una red de zona activa a petición específica.

El código de la tarea en segundo plano debe convertir el valor de la propiedad IBackgroundTaskInstance.TriggerDetails en WiFiOnDemandHotspotConnectTriggerDetails.

Nota:

Si quieres usar esta API en una aplicación para UWP y publicar la aplicación en Microsoft Store, tendrás que solicitar una aprobación especial para usar la funcionalidad personalizada Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (la funcionalidad red a petición). Para obtener más información, consulta Funcionalidades personalizadas.

La funcionalidad Red a petición solo estará disponible para los desarrolladores de aplicaciones que crean escenarios de punto de acceso de un extremo a otro Wi-Fi entre un dispositivo de hardware compatible con tethering y un equipo Windows.

WiFiOnDemandHotspotUpdateMetadataTrigger

Representa un evento que hace que se ejecute una tarea en segundo plano cuando el usuario abra el sistema operativo (SO) Wi-Fi lista de red, como si se conectara a una nueva red Wi-Fi.

Nota:

Si quieres usar esta API en una aplicación para UWP y publicar la aplicación en Microsoft Store, tendrás que solicitar una aprobación especial para usar la funcionalidad personalizada Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (la funcionalidad red a petición). Para obtener más información, consulta Funcionalidades personalizadas.

La funcionalidad Red a petición solo estará disponible para los desarrolladores de aplicaciones que crean escenarios de punto de acceso de un extremo a otro Wi-Fi entre un dispositivo de hardware compatible con tethering y un equipo Windows.

Interfaces

IBackgroundCondition

Se usa para aplicar el tipo de objeto de condición del sistema.

IBackgroundTask

Proporciona un método para realizar el trabajo de una tarea en segundo plano.

IBackgroundTaskInstance

Proporciona acceso a una instancia de tarea en segundo plano.

IBackgroundTaskInstance2

Proporciona acceso a una instancia de tarea en segundo plano. Hereda de la interfaz IBackgroundTaskInstance y agrega el método GetThrottleCount .

IBackgroundTaskInstance4

Proporciona acceso a una instancia de tarea en segundo plano, incluida la información sobre el usuario.

IBackgroundTaskRegistration

Proporciona acceso a una tarea en segundo plano registrada.

IBackgroundTaskRegistration2

Proporciona acceso a una tarea en segundo plano registrada. Hereda de la interfaz IBackgroundTaskRegistration y agrega la propiedad Trigger .

IBackgroundTaskRegistration3

Representa una tarea en segundo plano que se ha registrado como parte de un grupo de tareas en segundo plano relacionadas.

IBackgroundTrigger

Representa la interfaz base para los eventos de desencadenador.

Enumeraciones

AlarmAccessStatus

Indica si el usuario ha concedido permiso para que la aplicación establezca alarmas.

ApplicationTriggerResult

Resultado de la solicitud para desencadenar una tarea en segundo plano. El método RequestAsync devuelve un valor de este tipo de enumeración.

BackgroundAccessRequestKind

Especifica el nivel de actividad en segundo plano que una aplicación puede solicitar.

BackgroundAccessStatus

Esta enumeración especifica la capacidad de una aplicación para realizar actividades en segundo plano.

Las aplicaciones deben llamar correctamente a BackgroundExecutionManager.RequestAccessAsync antes de registrar tareas en segundo plano.

BackgroundTaskCancellationReason

Especifica los motivos para cancelar una tarea en segundo plano.

BackgroundTaskThrottleCounter

Indica el tipo de recuento de limitaciones que se va a comprobar en una solicitud GetThrottleCount .

BackgroundWorkCostValue

Indica el costo actual de realizar el trabajo en segundo plano. Se usa como sugerencia para realizar tareas en segundo plano sobre cuánto trabajo pueden hacer.

CustomSystemEventTriggerRecurrence

Especifica cuándo se puede activar customSystemEventTrigger .

DeviceTriggerResult

Indica si se ha permitido o denegado la operación de tarea en segundo plano del dispositivo y si se denegó especifica el motivo.

EnergyUseLevel

Permite a una aplicación programar tareas en segundo plano para ejecutar código de aplicación incluso cuando la aplicación está suspendida.

Las tareas en segundo plano están diseñadas para elementos de trabajo pequeños que no requieren interacción del usuario ni para controlar las acciones del sistema. Los escenarios adecuados para las tareas en segundo plano incluyen descargar correo, mostrar una notificación del sistema para un mensaje de chat entrante o reaccionar ante un cambio en una condición del sistema.

Consulta Compatibilidad de la aplicación con tareas en segundo plano ( con JavaScript y HTML) o Compatibilidad con la aplicación con tareas en segundo plano para obtener instrucciones sobre cómo implementar tareas en segundo plano. Para obtener código de ejemplo que muestra cómo implementar tareas en segundo plano, vea ejemplo de tarea en segundo plano.

LocationTriggerType

Indica un tipo de evento de ubicación para un desencadenador de tarea en segundo plano de ubicación.

MediaProcessingTriggerResult

Especifica el resultado de una llamada a MediaProcessingTrigger.RequestAsync.

SystemConditionType

Especifica una condición del sistema que debe estar en vigor para que se ejecute una tarea en segundo plano. Si se desencadena una tarea en segundo plano con una condición del sistema, la tarea no se ejecutará hasta que se cumpla la condición.

SystemTriggerType

Especifica los eventos del sistema que se pueden usar para desencadenar una tarea en segundo plano.

Delegados

BackgroundTaskCanceledEventHandler

Representa un método que controla la cancelación de una tarea en segundo plano.

BackgroundTaskCompletedEventHandler

Representa un método que controla los eventos de finalización de una tarea en segundo plano.

BackgroundTaskProgressEventHandler

Representa un método que controla los eventos de actualización de progreso de una tarea en segundo plano.

Consulte también