DeviceServicingTrigger Classe

Definição

Namespace:

Windows.ApplicationModel.Background

Representa um evento que um aplicativo pode disparar para iniciar uma atualização de longa execução (firmware ou configurações) de um dispositivo.

Windows 8.1 permite desenvolver um aplicativo UWP para seus dispositivos periféricos que se comunicam por USB, HID e Bluetooth. Por exemplo, um usuário pode precisar sincronizar conteúdo em um computador de ou para o dispositivo ou executar uma atualização de longa execução para o próprio dispositivo, como configurações ou atualizações de firmware. Windows 8.1 fornece duas tarefas em segundo plano e APIs correspondentes que permitem que seu dispositivo sincronize e atualize em segundo plano: DeviceServicingTrigger e DeviceUseTrigger. Este tópico fornece informações de referência de API para DeviceServicingTrigger – para obter informações sobre como usar esse gatilho no contexto de um aplicativo de dispositivo, consulte Sincronização de dispositivos e atualização para aplicativos de dispositivo UWP.

A tarefa em segundo plano DeviceServicingTrigger permite que seu aplicativo UWP que interage com seu dispositivo periférico execute atualizações de dispositivo de longa execução enquanto seu aplicativo está suspenso, por exemplo, transferências de configurações ou atualizações de firmware. Atualizar seu dispositivo em segundo plano requer a aprovação do usuário sempre que a tarefa em segundo plano é usada. Ao contrário da tarefa em segundo plano deviceUseTrigger , a tarefa em segundo plano DeviceServicingTrigger permite a reinicialização e desconexão do dispositivo e permite um máximo de 30 minutos de atividade em segundo plano.

• Mais detalhes sobre os requisitos de política da tarefa em segundo plano DeviceServicingTrigger podem ser encontrados na seção desta página.
• Para obter informações sobre como usar o DeviceServicingTrigger, consulte Sincronização e atualização de dispositivo para aplicativos de dispositivo UWP.
• Para obter informações sobre como usar o DeviceUseTrigger, 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.

public ref class DeviceServicingTrigger 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 DeviceServicingTrigger 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 DeviceServicingTrigger

function DeviceServicingTrigger()

Public NotInheritable Class DeviceServicingTrigger

Herança

Object Platform::Object IInspectable DeviceServicingTrigger

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

Determinadas políticas são impostas pelo Windows para garantir o consentimento do usuário ao atualizar seus dispositivos periféricos. Fazem-se cumprir políticas adicionais para economizar a duração da bateria do usuário ao sincronizar e atualizar dispositivos periféricos. A tarefa em segundo plano DeviceServicingTrigger está sujeita às seguintes políticas:

• A tarefa em segundo plano DeviceServicingTrigger requer o consentimento do usuário sempre que é disparada.
• Seu dispositivo deve estar conectado ou emparelhado com o computador e disponível ao solicitar o DeviceServicingTrigger.
• Seu aplicativo tem um máximo de 30 minutos (relógio de parede) de atividade em segundo plano para atualizações de dispositivo com DeviceServicingTrigger
• Seu aplicativo não tem permissão para solicitar uma tarefa em segundo plano deviceServicingTrigger enquanto seu aplicativo não estiver em primeiro plano.
• Seu aplicativo só pode executar um DeviceServicingTrigger por vez. Tentar criar um segundo DeviceServicingTrigger gerará uma exceção.
• A bateria do computador deve ter mais de 33% de capacidade restante ou o computador deve estar com energia A/C.
• As tarefas em segundo plano de DeviceServicingTrigger podem ser canceladas pelo Windows quando esses requisitos de política não forem mais atendidos, incluindo uma quantidade máxima de tempo em segundo plano do relógio de parede.

Observação

O aplicativo UWP que pretende usar a tarefa em segundo plano DeviceServicingTrigger também deve ser um aplicativo privilegiado para o dispositivo. O privilégio de aplicativo é especificado nos metadados do dispositivo para um dispositivo periférico pelo fabricante do dispositivo. Quando um aplicativo UWP tenta disparar a tarefa em segundo plano DeviceServicingTrigger , o Windows valida que o aplicativo de chamada é o aplicativo privilegiado para o dispositivo que está tentando atualizar. Se o aplicativo não tiver privilégios para o dispositivo, o Windows não permitirá que a tarefa em segundo plano seja iniciada.

Para obter informações detalhadas sobre o privilégio do aplicativo e as verificações de política impostas pelo Windows para a tarefa em segundo plano DeviceServicingTrigger , consulte Sincronização de dispositivos e atualização para aplicativos de dispositivo UWP.

Construtores

DeviceServicingTrigger()

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

Métodos

RequestAsync(String, TimeSpan)

Dispara a tarefa em segundo plano (configurações ou atualização de firmware) e retorna um DeviceTriggerResult indicando êxito ou falha da solicitação de gatilho. Usa a cadeia de caracteres DeviceInformation.ID e um tempo estimado opcional que a tarefa em segundo plano executará. Se seu aplicativo não puder determinar uma estimativa de tempo apropriada, forneça zero como o tempo estimado.

RequestAsync(String, TimeSpan, String)

Dispara a tarefa em segundo plano (configurações ou atualização de firmware) e retorna um DeviceTriggerResult indicando êxito ou falha da solicitação de gatilho. Usa a cadeia de caracteres DeviceInformation.ID , um tempo estimado opcional que a tarefa em segundo plano será executada e uma cadeia de caracteres opcional específica do aplicativo passada para a tarefa em segundo plano que identifica qual operação de dispositivo executar. Se seu aplicativo não puder determinar uma estimativa de tempo apropriada, forneça zero como o tempo estimado.

Confira também

• IBackgroundTrigger