Windows.ApplicationModel.Background Espacio de nombres
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.
|
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
- Ejemplo de tarea en segundo plano (Windows 10)
- Ejemplo de ejecución extendida (Windows 10)
- Ejemplo de dispositivo USB personalizado (Windows 10)
- Ejemplo de bloqueo y filtrado de comunicaciones
- Ejemplo de activación en segundo plano
- Muestra de DatagramSocket
- Muestra StreamSocket
- Ejemplo de código adaptable de versión