DeviceUseTrigger Classe

  • Referência

Definição

Namespace:
Windows.ApplicationModel.Background
Editar

Representa um evento que um aplicativo Windows Runtime pode disparar para iniciar uma operação de longa execução com um dispositivo ou sensor.

DeviceUseTrigger permite que seu aplicativo Windows Runtime acesse sensores e dispositivos periféricos em segundo plano, mesmo quando seu aplicativo em primeiro plano é suspenso. Por exemplo, dependendo de onde o seu aplicativo estiver sendo executado, ele poderá usar uma tarefa em segundo plano para sincronizar dados com dispositivos ou monitorar sensores.

Essa classe pode ser usada no aplicativo UWP e Windows Phone aplicativo 8.x. No entanto, uma tarefa em segundo plano do DeviceUseTrigger dá suporte a APIs diferentes e está sujeita a políticas diferentes, dependendo de onde está em execução (computador ou telefone). Para saber mais sobre essas diferenças, consulte Acessando sensores e dispositivos de uma tarefa em segundo plano.

Importante

Esse gatilho não pode ser usado com tarefas em segundo plano de processo único.

Para obter um exemplo que mostra como usar DeviceUseTrigger em um computador, consulte o exemplo de dispositivo USB personalizado. Para obter um exemplo de telefone, consulte o exemplo sensores de plano de fundo.

public ref class DeviceUseTrigger sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class DeviceUseTrigger final
/// [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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class DeviceUseTrigger
[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
Herança
Object Platform::Object IInspectable DeviceUseTrigger
Atributos
ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute
Implementações
IBackgroundTrigger

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

Para obter mais informações sobre os requisitos de política, consulte Acessando sensores e dispositivos de uma tarefa em segundo plano

Antes que seu aplicativo dispare uma tarefa em segundo plano em um telefone, ele deve primeiro chamar BackgroundExecutionManager.RequestAccessAsync para marcar se o aplicativo puder solicitar uma tarefa em segundo plano. Esse marcar não é necessário quando seu aplicativo está em execução em um computador.

Construtores

DeviceUseTrigger()

Construtor para DeviceUseTrigger. Não usa parâmetros.

Métodos

RequestAsync(String)

Dispara a tarefa em segundo plano e retorna um DeviceTriggerResult que indica êxito ou falha da solicitação de gatilho. Usa o DeviceInformation.ID do dispositivo ou sensor que a tarefa em segundo plano acessará.
RequestAsync(String, String)

Dispara a tarefa em segundo plano e retorna um DeviceTriggerResult que indica êxito ou falha da solicitação de gatilho. Usa o DeviceInformation.ID do dispositivo ou sensor que a tarefa em segundo plano acessará e uma cadeia de caracteres opcional específica do aplicativo passada para a tarefa em segundo plano que identifica qual operação executar.

Aplica-se a

Confira também