Windows.ApplicationModel.Background Namespace

Permite que um aplicativo agende tarefas em segundo plano para executar o código do aplicativo mesmo quando o aplicativo é suspenso.

As tarefas em segundo plano destinam-se a pequenos itens de trabalho que não exigem interação do usuário ou para lidar com ações do sistema. Os cenários apropriados para tarefas em segundo plano incluem baixar emails, mostrar uma notificação do sistema para uma mensagem de chat recebida ou reagir a uma alteração em uma condição do sistema.

Consulte Suporte ao seu aplicativo com tarefas em segundo plano (usando JavaScript e HTML) ou Suporte ao seu aplicativo com tarefas em segundo plano para obter diretrizes sobre como implementar tarefas em segundo plano. Por exemplo, código que mostra como implementar tarefas em segundo plano, consulte o Exemplo de tarefa em segundo plano.

Classes

ActivitySensorTrigger

Representa um gatilho que é ativado quando ActivitySensor recebe entrada. Isso é usado quando seu aplicativo precisa responder ao sensor de atividade.

AlarmApplicationManager

Solicita permissão do usuário para definir alarmes e recupera o status de permissão do usuário para o aplicativo definir alarmes.

AppBroadcastTrigger

Representa um evento que dispara uma tarefa em segundo plano a ser executada quando um aplicativo inicia a transmissão de jogo.

AppBroadcastTriggerProviderInfo

Fornece informações sobre o aplicativo que está transmitindo a jogabilidade, como seu logotipo, nome de exibição e características de vídeo.

ApplicationTrigger

Isso permite que você dispare programaticamente uma tarefa em segundo plano de dentro do aplicativo.

ApplicationTriggerDetails

Os detalhes de um ApplicationTrigger.

AppointmentStoreNotificationTrigger

Representa um gatilho que inicia uma tarefa em segundo plano para processar alterações no repositório de compromissos.

BackgroundExecutionManager

Gerenciar permissão para executar tarefas em segundo plano.

BackgroundTaskBuilder

Representa uma tarefa em segundo plano a ser registrada no sistema.

BackgroundTaskCompletedEventArgs

Representa informações de conclusão de uma tarefa no momento em que uma notificação de conclusão é enviada.

BackgroundTaskDeferral

Representa um adiamento de tarefa em segundo plano retornado pelo método IBackgroundTaskInstance.GetDeferral .

BackgroundTaskProgressEventArgs

Representa informações de progresso para uma tarefa no momento em que uma notificação de atualização de progresso é enviada.

BackgroundTaskRegistration

Representa uma tarefa em segundo plano que foi registrada com o sistema.

BackgroundTaskRegistrationGroup

Fornece semântica de agrupamento para que o registro de tarefas em segundo plano possa ser mantido separadamente.

BackgroundWorkCost

Recupera uma dica sobre a disponibilidade de recursos para tarefas em segundo plano. As tarefas em segundo plano podem usar essa dica para decidir quanto trabalho fazer quando são ativadas.

BluetoothLEAdvertisementPublisherTrigger

Representa um gatilho registrado para anunciar um anúncio de LE Bluetooth em segundo plano.

BluetoothLEAdvertisementWatcherTrigger

Representa um gatilho registrado para verificar se há anúncio de LE Bluetooth em segundo plano.

CachedFileUpdaterTrigger

Representa um gatilho que inicia uma tarefa em segundo plano para habilitar o contrato do Atualizador de Arquivos Armazenado em Cache.

CachedFileUpdaterTriggerDetails

Fornece detalhes sobre a operação de arquivo armazenado em cache que invocou o gatilho.

ChatMessageNotificationTrigger

Representa um gatilho que é ativado quando há uma notificação para uma mensagem de texto.

ChatMessageReceivedNotificationTrigger

Representa um gatilho que inicia uma tarefa em segundo plano que manipula qualquer mensagem de entrada que possa precisar ser filtrada de acordo com seu conteúdo. Para obter mais informações sobre como filtrar mensagens, consulte Windows.ApplicationModel.CommunicationBlocking.

CommunicationBlockingAppSetAsActiveTrigger

Representa um gatilho para ativar um aplicativo de bloqueio de comunicação quando ele é selecionado como o aplicativo de bloqueio preferencial.

Um usuário pode ter vários aplicativos de bloqueio de comunicação instalados ao mesmo tempo. Esse gatilho é usado para informar um aplicativo que ele foi selecionado como o aplicativo de bloqueio de comunicação ativo. Para obter mais informações sobre a API de bloqueio de comunicação, consulte Windows.ApplicationModel.CommunicationBlocking.

ContactStoreNotificationTrigger

Representa um gatilho que inicia uma tarefa em segundo plano para processar alterações no repositório de contatos.

ContentPrefetchTrigger

Fornece a capacidade de executar manipuladores personalizados ao pré-busca de recursos da Web.

ConversationalAgentTrigger

Representa um gatilho que inicia uma tarefa em segundo plano para processar a comunicação de assistente digital por meio do AAR (Tempo de Execução de Ativação do Agente da plataforma Windows).

CustomSystemEventTrigger

Essa classe permite que você especifique um gatilho de sistema personalizado para que você possa registrá-lo e responder quando ele for disparado pelo sistema.

DeviceConnectionChangeTrigger

Representa um gatilho que inicia uma tarefa em segundo plano quando a conexão status de um dispositivo é alterada.

DeviceManufacturerNotificationTrigger

Representa um gatilho que inicia uma tarefa em segundo plano para habilitar operações do fabricante do dispositivo.

DeviceServicingTrigger

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 o 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 o 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 no máximo 30 minutos de atividade em segundo plano.

Importante

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

DeviceUseTrigger

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.

DeviceWatcherTrigger

Representa um evento que faz com que uma tarefa em segundo plano seja executada quando ocorrem alterações na lista de dispositivos. Retornado por GetBackgroundTrigger.

EmailStoreNotificationTrigger

Representa um gatilho que habilita a notificação de alterações no repositório de emails.

GattCharacteristicNotificationTrigger

Representa um gatilho que inicia uma tarefa em segundo plano quando uma notificação de alteração de entrada é recebida para uma característica de GATT DE LE Bluetooth.

GattServiceProviderTrigger

Constrói um serviço GATT (Atributos Genéricos) que pode ser persistido em segundo plano.

GattServiceProviderTriggerResult

Essa classe contém o gatilho criado por GattServiceProviderTrigger.CreateAsync().

GeovisitTrigger

Representa um evento que dispara uma tarefa em segundo plano relacionada a Visitas.

LocationTrigger

Representa um evento de local que dispara uma tarefa em segundo plano. Isso é usado para cerca geográfica.

MaintenanceTrigger

Representa um gatilho de manutenção.

MediaProcessingTrigger

Representa um gatilho que inicia uma tarefa em segundo plano para executar o processamento de mídia.

MobileBroadbandDeviceServiceNotificationTrigger

Representa um gatilho que é ativado quando a rede envia comandos da ferramenta SIM. Os aplicativos que recebem essa notificação processam os comandos da ferramenta SIM.

Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativo UWP com acesso privilegiado por operadoras de rede móvel. Para obter mais informações, consulte Banda larga móvel.

MobileBroadbandPcoDataChangeTrigger

Representa um evento de alteração de opção de configuração de protocolo celular que dispara uma tarefa em segundo plano a ser executada.

MobileBroadbandPinLockStateChangeTrigger

Representa um gatilho que indica quando o estado de bloqueio do PIN do SIM foi alterado.

Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativo UWP com acesso privilegiado por operadoras de rede móvel. Para obter mais informações, consulte Banda larga móvel.

MobileBroadbandRadioStateChangeTrigger

Representa um gatilho que indica quando o estado de rádio de banda larga móvel foi alterado. Por exemplo, esse gatilho é ativado quando um dispositivo móvel faz a transição de ou para o modo avião.

Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativo UWP com acesso privilegiado por operadoras de rede móvel. Para obter mais informações, consulte Banda larga móvel.

MobileBroadbandRegistrationStateChangeTrigger

Representa um gatilho que indica quando o estado de registro de banda larga móvel foi alterado. Por exemplo, esse gatilho é ativado quando um dispositivo móvel faz a transição de ou para Roaming.

Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativo UWP com acesso privilegiado por operadoras de rede móvel. Para obter mais informações, consulte Banda larga móvel.

NetworkOperatorDataUsageTrigger

Representa um gatilho que inicia uma tarefa em segundo plano quando os contadores de dados locais estimam que o uso (bytes enviados e recebidos) na interface de banda larga móvel foi alterado por um limite acionável.

Observação

Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativos UWP com acesso privilegiado por operadoras de rede móvel.

Se você quiser usar essa API e publicar seu aplicativo na Microsoft Store, precisará de aprovação especial. Para obter mais informações, consulte a seção Funcionalidades restritas no tópico Declarações de funcionalidade do aplicativo e Banda Larga Móvel.

NetworkOperatorHotspotAuthenticationTrigger

Representa um gatilho de autenticação de hotspot da operadora de rede móvel.

Observação

Um aplicativo só pode instanciar esse objeto e registrar-se para o evento de autenticação de hotspot depois que um perfil WLAN foi provisionado que faz referência a esse aplicativo para lidar com a autenticação de hotspot. Para obter mais informações, consulte Integração do Windows 8 para operadores de hotspot sem fio.

NetworkOperatorNotificationTrigger

Representa um gatilho de notificação da operadora de rede móvel.

PaymentAppCanMakePaymentTrigger

Essa classe representa um gatilho PaymentAppCanMakePayment.

PhoneTrigger

Representa um evento de telefone que dispara uma tarefa em segundo plano.

PushNotificationTrigger

Representa um objeto que invoca um item de trabalho em segundo plano no aplicativo em resposta ao recebimento de uma notificação bruta.

RcsEndUserMessageAvailableTrigger

Representa um gatilho que inicia uma tarefa em segundo plano quando uma nova mensagem dos Serviços de Comunicação Avançada (RCS) está disponível.

RfcommConnectionTrigger

Representa um gatilho que inicia uma tarefa em segundo plano quando uma conexão de entrada ou saída RFCOMM é estabelecida.

SecondaryAuthenticationFactorAuthenticationTrigger

Representa um gatilho que inicia uma tarefa em segundo plano em nome de um dispositivo complementar.

SensorDataThresholdTrigger

Representa um gatilho que responde quando um limite de um sensor é cruzado.

SmartCardTrigger

Representa um evento disparado por um cartão inteligente.

SmsMessageReceivedTrigger

Representa um gatilho que é gerado quando uma mensagem SMS chega.

SocketActivityTrigger

Representa um gatilho que inicia uma tarefa em segundo plano para lidar com a atividade de soquete.

StorageLibraryChangeTrackerTrigger

Representa uma alteração de arquivo em uma StorageFolder que dispara uma tarefa em segundo plano a ser executada.

StorageLibraryContentChangedTrigger

Cria um gatilho que será acionado quando um arquivo for alterado em uma biblioteca especificada.

SystemCondition

Representa uma condição do sistema que deve estar em vigor para que uma tarefa em segundo plano seja executada.

SystemTrigger

Representa um evento do sistema que dispara uma tarefa em segundo plano a ser executada.

TetheringEntitlementCheckTrigger

Representa um evento de amarração que dispara uma tarefa em segundo plano a ser executada.

TimeTrigger

Representa um evento de tempo que dispara uma tarefa em segundo plano a ser executada.

ToastNotificationActionTrigger

Representa um evento que faz com que uma tarefa em segundo plano seja executada quando o usuário executa uma ação em uma notificação interativa do sistema.

ToastNotificationHistoryChangedTrigger

Representa um evento que faz com que uma tarefa em segundo plano seja executada quando o histórico de notificações do sistema para o aplicativo é limpo, quando uma ou mais notificações do sistema são adicionadas ou removidas do histórico de notificações do aplicativo ou quando uma ou mais notificações do sistema para o aplicativo expiram e são removidas do histórico de notificações.

UserNotificationChangedTrigger

Representa um gatilho que é acionado quando uma UserNotification é adicionada ou removida.

WiFiOnDemandHotspotConnectTrigger

Representa um evento que faz com que uma tarefa em segundo plano seja executada quando o usuário deseja se conectar a uma rede de hotspot sob demanda específica.

O código da tarefa em segundo plano deve converter o valor da propriedade IBackgroundTaskInstance.TriggerDetails em WiFiOnDemandHotspotConnectTriggerDetails.

Observação

Se você quiser usar essa API em um aplicativo UWP e publicar seu aplicativo na Microsoft Store, precisará solicitar aprovação especial para usar a funcionalidade personalizada Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (a funcionalidade rede sob demanda). Para obter mais informações, consulte Recursos personalizados.

A funcionalidade rede sob demanda será disponibilizada somente para desenvolvedores de aplicativos que criam cenários de hotspot de ponta a ponta Wi-Fi entre um dispositivo de hardware compatível com tethering e um computador Windows.

WiFiOnDemandHotspotUpdateMetadataTrigger

Representa um evento que faz com que uma tarefa em segundo plano seja executada quando o usuário abre o sistema operacional (SO) Wi-Fi lista de rede, como se se conectasse a uma nova rede Wi-Fi.

Observação

Se você quiser usar essa API em um aplicativo UWP e publicar seu aplicativo na Microsoft Store, precisará solicitar aprovação especial para usar a funcionalidade personalizada Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (a funcionalidade rede sob demanda). Para obter mais informações, consulte Recursos personalizados.

A funcionalidade rede sob demanda será disponibilizada somente para desenvolvedores de aplicativos que criam cenários de hotspot de ponta a ponta Wi-Fi entre um dispositivo de hardware compatível com tethering e um computador Windows.

Interfaces

IBackgroundCondition

Usado para impor o tipo de objeto de condição do sistema.

IBackgroundTask

Fornece um método para executar o trabalho de uma tarefa em segundo plano.

IBackgroundTaskInstance

Fornece acesso a uma instância de tarefa em segundo plano.

IBackgroundTaskInstance2

Fornece acesso a uma instância de tarefa em segundo plano. Herda da interface IBackgroundTaskInstance e adiciona o método GetThrottleCount .

IBackgroundTaskInstance4

Fornece acesso a uma instância de tarefa em segundo plano, incluindo informações sobre o usuário.

IBackgroundTaskRegistration

Fornece acesso a uma tarefa em segundo plano registrada.

IBackgroundTaskRegistration2

Fornece acesso a uma tarefa em segundo plano registrada. Herda da interface IBackgroundTaskRegistration e adiciona a propriedade Trigger .

IBackgroundTaskRegistration3

Representa uma tarefa em segundo plano que foi registrada como parte de um grupo de tarefas em segundo plano relacionadas.

IBackgroundTrigger

Representa a interface base para eventos de gatilho.

Enumerações

AlarmAccessStatus

Indica se o usuário deu permissão para o aplicativo definir alarmes.

ApplicationTriggerResult

O resultado da solicitação para disparar uma tarefa em segundo plano. O método RequestAsync retorna um valor desse tipo de enumeração.

BackgroundAccessRequestKind

Especifica o nível de atividade em segundo plano que um aplicativo pode solicitar.

BackgroundAccessStatus

Essa enumeração especifica a capacidade de um aplicativo de executar atividades em segundo plano.

Os aplicativos devem chamar BackgroundExecutionManager.RequestAccessAsync com êxito antes de registrar tarefas em segundo plano.

BackgroundTaskCancellationReason

Especifica os motivos para cancelar uma tarefa em segundo plano.

BackgroundTaskThrottleCounter

Indica o tipo de contagem de limitação para marcar em uma solicitação GetThrottleCount.

BackgroundWorkCostValue

Indica o custo atual de fazer trabalho em segundo plano. Usado como uma dica para tarefas em segundo plano sobre quanto trabalho eles podem fazer.

CustomSystemEventTriggerRecurrence

Especifica quando um CustomSystemEventTrigger pode ser ativado.

DeviceTriggerResult

Indica se a operação de tarefa em segundo plano do dispositivo foi permitida ou negada e, se foi negada, especifica o motivo.

EnergyUseLevel

Permite que um aplicativo agende tarefas em segundo plano para executar o código do aplicativo mesmo quando o aplicativo é suspenso.

As tarefas em segundo plano destinam-se a pequenos itens de trabalho que não exigem interação do usuário ou para lidar com ações do sistema. Os cenários apropriados para tarefas em segundo plano incluem baixar emails, mostrar uma notificação do sistema para uma mensagem de chat recebida ou reagir a uma alteração em uma condição do sistema.

Consulte Suporte ao seu aplicativo com tarefas em segundo plano (usando JavaScript e HTML) ou Suporte ao seu aplicativo com tarefas em segundo plano para obter diretrizes sobre como implementar tarefas em segundo plano. Por exemplo, código que mostra como implementar tarefas em segundo plano, consulte o Exemplo de tarefa em segundo plano.

LocationTriggerType

Indica um tipo de evento de local para um gatilho de tarefa em segundo plano de localização.

MediaProcessingTriggerResult

Especifica o resultado de uma chamada para MediaProcessingTrigger.RequestAsync.

SystemConditionType

Especifica uma condição do sistema que deve estar em vigor para que uma tarefa em segundo plano seja executada. Se uma tarefa em segundo plano com uma condição do sistema for disparada, a tarefa não será executada até que a condição seja atendida.

SystemTriggerType

Especifica os eventos do sistema que podem ser usados para disparar uma tarefa em segundo plano.

Delegados

BackgroundTaskCanceledEventHandler

Representa um método que manipula o cancelamento de uma tarefa em segundo plano.

BackgroundTaskCompletedEventHandler

Representa um método que manipula eventos de conclusão para uma tarefa em segundo plano.

BackgroundTaskProgressEventHandler

Representa um método que manipula eventos de atualização de progresso para uma tarefa em segundo plano.

Confira também