DeviceUseTrigger Clase

Definición

Espacio de nombres:

Windows.ApplicationModel.Background

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 distintas API y está sujeta a diferentes directivas, dependiendo 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.

public ref class DeviceUseTrigger sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class DeviceUseTrigger final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class DeviceUseTrigger

function DeviceUseTrigger()

Public NotInheritable Class DeviceUseTrigger

Herencia

Object Platform::Object IInspectable DeviceUseTrigger

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementaciones

IBackgroundTrigger

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

Para más información sobre los requisitos de directiva, consulte Acceso a sensores y dispositivos desde una tarea en segundo plano.

Antes de que la aplicación desencadene una tarea en segundo plano en un teléfono, primero debe llamar a BackgroundExecutionManager.RequestAccessAsync para comprobar si la aplicación puede solicitar una tarea en segundo plano. Esta comprobación no es necesaria cuando la aplicación se ejecuta en un equipo.

Constructores

DeviceUseTrigger()

Constructor para DeviceUseTrigger. No toma parámetros.

Métodos

RequestAsync(String)	Desencadena la tarea en segundo plano y devuelve un deviceTriggerResult que indica que la solicitud del desencadenador se ha realizado correctamente o no. Toma el DeviceInformation.ID del dispositivo o sensor al que accederá la tarea en segundo plano.
RequestAsync(String, String)	Desencadena la tarea en segundo plano y devuelve un deviceTriggerResult que indica que la solicitud del desencadenador se ha realizado correctamente o no. Toma el DeviceInformation.ID del dispositivo o sensor al que accederá la tarea en segundo plano y una cadena opcional específica de la aplicación que se pasa a la tarea en segundo plano que identifica qué operación realizar.

Consulte también

• IBackgroundTrigger