Поделиться через


Windows.ApplicationModel.Background Пространство имен

Позволяет приложению планировать фоновые задачи для запуска кода приложения, даже если приложение приостановлено.

Фоновые задачи предназначены для небольших рабочих элементов, не требующих взаимодействия с пользователем, или для обработки всплывающих действий. Сценарии, подходящие для фоновых задач, включают загрузку почты, отображение всплывающего уведомления для входящего сообщения чата или реагирование на изменение состояния системы.

Инструкции по реализации фоновых задач см. в статье Поддержка приложения с помощью фоновых задач (с помощью JavaScript и HTML) или Поддержка приложения с помощью фоновых задач . Пример кода, демонстрирующего реализацию фоновых задач, см. в разделе Пример фоновой задачи.

Классы

ActivitySensorTrigger

Представляет триггер, активируемый, когда ActivitySensor получает входные данные. Он используется, когда приложение должно реагировать на датчик активности.

AlarmApplicationManager

Запрашивает у пользователя разрешение на настройку оповещений и получает состояние разрешения пользователя для приложения на настройку оповещений.

AppBroadcastTrigger

Представляет событие, которое запускает фоновую задачу для запуска, когда приложение начинает трансляцию игрового процесса.

AppBroadcastTriggerProviderInfo

Предоставляет сведения о приложении, которое транслирует игровой процесс, например его логотип, отображаемое имя и характеристики видео.

ApplicationTrigger

Это позволяет программно активировать фоновую задачу из приложения.

ApplicationTriggerDetails

Сведения о ApplicationTrigger.

AppointmentStoreNotificationTrigger

Представляет триггер, запускающий фоновую задачу для обработки изменений в хранилище встреч.

BackgroundExecutionManager

Управление разрешениями на выполнение фоновых задач.

BackgroundTaskBuilder

Представляет фоновую задачу для регистрации в системе.

BackgroundTaskCompletedEventArgs

Представляет сведения о завершении задачи на момент отправки уведомления о завершении.

BackgroundTaskDeferral

Представляет отсрочку фоновой задачи, возвращаемую методом IBackgroundTaskInstance.GetDeferral .

BackgroundTaskProgressEventArgs

Представляет сведения о ходе выполнения задачи во время отправки уведомления об обновлении хода выполнения.

BackgroundTaskRegistration

Представляет фоновую задачу, зарегистрированную в системе.

BackgroundTaskRegistrationGroup

Предоставляет семантику группирования, чтобы регистрация фоновых задач поддерживалась отдельно.

BackgroundWorkCost

Извлекает подсказку о доступности ресурсов для фоновых задач. Фоновые задачи могут использовать это указание, чтобы решить, сколько работы необходимо выполнить при их активации.

BluetoothLEAdvertisementPublisherTrigger

Представляет триггер, зарегистрированный для объявления объявления Bluetooth LE в фоновом режиме.

BluetoothLEAdvertisementWatcherTrigger

Представляет триггер, зарегистрированный для сканирования объявления Bluetooth LE в фоновом режиме.

CachedFileUpdaterTrigger

Представляет триггер, запускающий фоновую задачу для включения контракта кэшированного обновления файлов.

CachedFileUpdaterTriggerDetails

Предоставляет сведения об операции с кэшированными файлами, которая вызвала триггер.

ChatMessageNotificationTrigger

Представляет триггер, активируемый при получении уведомления о текстовом сообщении.

ChatMessageReceivedNotificationTrigger

Представляет триггер, запускающий фоновую задачу, которая обрабатывает любое входящее сообщение, которое может потребоваться отфильтровать в соответствии с его содержимым. Дополнительные сведения о фильтрации сообщений см. в разделе Windows.ApplicationModel.CommunicationBlocking.

CommunicationBlockingAppSetAsActiveTrigger

Представляет триггер для активации приложения, блокирующего обмен данными, если оно выбрано в качестве предпочтительного приложения для блокировки.

Пользователь может одновременно установить несколько приложений, блокирующих обмен данными. Этот триггер используется, чтобы сообщить приложению, что оно было выбрано в качестве активного приложения, блокирующего обмен данными. Дополнительные сведения об API блокировки обмена данными см. в статье Windows.ApplicationModel.CommunicationBlocking.

ContactStoreNotificationTrigger

Представляет триггер, запускающий фоновую задачу для обработки изменений в хранилище контактов.

ContentPrefetchTrigger

Предоставляет возможность запуска пользовательских обработчиков при предварительной выборке веб-ресурсов.

ConversationalAgentTrigger

Представляет триггер, запускающий фоновую задачу для обработки цифрового помощник связи через среду выполнения активации агента платформы Windows (AAR).

CustomSystemEventTrigger

Этот класс позволяет указать настраиваемый системный триггер, чтобы его можно было зарегистрировать и отреагировать, когда он активируется системой.

DeviceConnectionChangeTrigger

Представляет триггер, запускающий фоновую задачу при изменении состояния подключения устройства.

DeviceManufacturerNotificationTrigger

Представляет триггер, запускающий фоновую задачу для включения операций изготовителя устройства.

DeviceServicingTrigger

Представляет событие, которое приложение может активировать для запуска длительного обновления (встроенного ПО или параметров) устройства.

Windows 8.1 позволяет разрабатывать приложение UWP для периферийных устройств, которые обмениваются данными по USB, HID и Bluetooth. Например, пользователю может потребоваться синхронизировать содержимое на компьютере с устройством или с устройства, а также выполнить длительное обновление самого устройства, например параметры или обновления встроенного ПО. Windows 8.1 предоставляет две фоновые задачи и соответствующие API, которые позволяют устройству синхронизироваться и обновляться в фоновом режиме: DeviceServicingTrigger и DeviceUseTrigger. В этом разделе приводятся справочные сведения об API для DeviceServicingTrigger. Сведения об использовании этого триггера в контексте приложения устройства см. в статье Синхронизация и обновление устройств для приложений UWP.

Фоновая задача DeviceServicingTrigger позволяет приложению UWP, взаимодействующим с периферийным устройством, выполнять длительные обновления устройств во время приостановки приложения, например передачу параметров или обновление встроенного ПО. Обновление устройства в фоновом режиме требует утверждения пользователем при каждом использовании фоновой задачи. В отличие от фоновой задачи DeviceUseTrigger фоновая задача DeviceServicingTrigger позволяет перезагружать и отключать устройство, а фоновые действия — не более 30 минут.

Важно!

Этот триггер нельзя использовать с однопроцессными фоновыми задачами.

DeviceUseTrigger

Представляет событие, которое приложение среда выполнения Windows может активировать для запуска длительной операции с устройством или датчиком.

DeviceUseTrigger позволяет приложению среда выполнения Windows получать доступ к датчикам и периферийным устройствам в фоновом режиме, даже если приложение переднего плана приостановлено. Например, в зависимости от того, где выполняется приложение, оно может использовать фоновую задачу, чтобы синхронизировать данные с устройством или отслеживать показания датчиков.

Этот класс можно использовать в приложении UWP и Windows Phone 8.x. Однако фоновая задача DeviceUseTrigger поддерживает разные API и регулируется разными политиками в зависимости от того, где она выполняется (компьютер или телефон). Дополнительные сведения об этих различиях см. в статье Доступ к датчикам и устройствам из фоновой задачи.

Важно!

Этот триггер нельзя использовать с однопроцессными фоновыми задачами.

Пример использования DeviceUseTrigger на компьютере см. в разделе Пример пользовательского USB-устройства. Пример телефона см. в разделе Пример датчика фона.

DeviceWatcherTrigger

Представляет событие, которое вызывает выполнение фоновой задачи при изменении списка устройств. Возвращается GetBackgroundTrigger.

EmailStoreNotificationTrigger

Представляет триггер, который включает уведомление об изменениях в хранилище электронной почты.

GattCharacteristicNotificationTrigger

Представляет триггер, запускающий фоновую задачу при получении входящего уведомления об изменениях для характеристики Bluetooth LE GATT.

GattServiceProviderTrigger

Создает службу универсальных атрибутов (GATT), которую можно сохранить в фоновом режиме.

GattServiceProviderTriggerResult

Этот класс содержит триггер, созданный GattServiceProviderTrigger.CreateAsync().

GeovisitTrigger

Представляет событие, которое активирует фоновую задачу, связанную с посещениями.

LocationTrigger

Представляет событие расположения, которое активирует фоновую задачу. Используется для геозон.

MaintenanceTrigger

Представляет триггер обслуживания.

MediaProcessingTrigger

Представляет триггер, запускающий фоновую задачу для выполнения обработки мультимедиа.

MobileBroadbandDeviceServiceNotificationTrigger

Представляет триггер, который активируется, когда сеть отправляет команды средства SIM-карты. Приложения, получающие это уведомление, затем обрабатывают команды средства SIM-карты.

Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети. Дополнительные сведения см. в разделе Мобильное широкополосное подключение.

MobileBroadbandPcoDataChangeTrigger

Представляет событие изменения параметра конфигурации протокола сотовой сети, которое активирует выполнение фоновой задачи.

MobileBroadbandPinLockStateChangeTrigger

Представляет триггер, указывающий, когда изменилось состояние блокировки ПИН-кода SIM-карты.

Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети. Дополнительные сведения см. в разделе Мобильное широкополосное подключение.

MobileBroadbandRadioStateChangeTrigger

Представляет триггер, указывающий, когда изменилось состояние мобильной широкополосной радиосвязи. Например, этот триггер активируется, когда мобильное устройство переходит в режим "в самолете" или из нее.

Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети. Дополнительные сведения см. в разделе Мобильное широкополосное подключение.

MobileBroadbandRegistrationStateChangeTrigger

Представляет триггер, указывающий, когда изменилось состояние регистрации мобильной широкополосной связи. Например, этот триггер активируется, когда мобильное устройство переходит в роуминг или из нее.

Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети. Дополнительные сведения см. в разделе Мобильное широкополосное подключение.

NetworkOperatorDataUsageTrigger

Представляет триггер, запускающий фоновую задачу, когда локальные счетчики данных оценивают, что использование (отправленных и полученных байтов) в интерфейсе мобильной широкополосной связи изменилось на допустимое пороговое значение.

Примечание

Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети.

Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется специальное утверждение. Дополнительные сведения см. в разделе Ограниченные возможности раздела Объявления возможностей приложений и Мобильное широкополосное подключение.

NetworkOperatorHotspotAuthenticationTrigger

Представляет триггер проверки подлинности хот-спота оператора мобильной сети.

Примечание

Приложение может создать экземпляр этого объекта и зарегистрироваться для события проверки подлинности хот-спота только после подготовки профиля WLAN, который ссылается на это приложение для обработки проверки подлинности с помощью хот-спота. Дополнительные сведения см. в статье Интеграция Windows 8 для операторов беспроводной хот-споты.

NetworkOperatorNotificationTrigger

Представляет триггер уведомления оператора мобильной сети.

PaymentAppCanMakePaymentTrigger

Этот класс представляет триггер PaymentAppCanMakePayment.

PhoneTrigger

Представляет событие телефона, которое активирует фоновую задачу.

PushNotificationTrigger

Представляет объект, который вызывает фоновый рабочий элемент в приложении в ответ на получение необработанного уведомления.

RcsEndUserMessageAvailableTrigger

Представляет триггер, запускающий фоновую задачу, когда доступно новое сообщение Служб коммуникации (RCS).

RfcommConnectionTrigger

Представляет триггер, запускающий фоновую задачу при установке входящих или исходящих подключений RFCOMM.

SecondaryAuthenticationFactorAuthenticationTrigger

Представляет триггер, запускающий фоновую задачу от имени устройства-компаньона.

SensorDataThresholdTrigger

Представляет триггер, который реагирует на превышение порогового значения для датчика.

SmartCardTrigger

Представляет событие, активируется смарт-карта.

SmsMessageReceivedTrigger

Представляет триггер, который возникает при поступлении SMS-сообщения.

SocketActivityTrigger

Представляет триггер, запускающий фоновую задачу для обработки действий сокета.

StorageLibraryChangeTrackerTrigger

Представляет изменение файла в папке StorageFolder , которая запускает фоновую задачу для выполнения.

StorageLibraryContentChangedTrigger

Создает триггер, который срабатывает при изменении файла в указанной библиотеке.

SystemCondition

Представляет системное условие, которое должно действовать для выполнения фоновой задачи.

SystemTrigger

Представляет системное событие, которое запускает фоновую задачу для выполнения.

TetheringEntitlementCheckTrigger

Представляет событие привязки, которое запускает фоновую задачу для выполнения.

TimeTrigger

Представляет событие времени, которое запускает фоновую задачу для выполнения.

ToastNotificationActionTrigger

Представляет событие, которое вызывает выполнение фоновой задачи, когда пользователь выполняет действие с интерактивным всплывляющим уведомлением.

ToastNotificationHistoryChangedTrigger

Представляет событие, которое вызывает выполнение фоновой задачи при очистке журнала всплывающих уведомлений для приложения, при добавлении или удалении одного или нескольких всплывающих уведомлений из журнала уведомлений для приложения или при удалении одного или нескольких всплывающих уведомлений для приложения истечет и удаляются из журнала уведомлений.

UserNotificationChangedTrigger

Представляет триггер, который срабатывает при добавлении или удалении userNotification .

WiFiOnDemandHotspotConnectTrigger

Представляет событие, которое вызывает выполнение фоновой задачи, когда пользователь хочет подключиться к определенной сети хот-спотов по запросу.

Код фоновой задачи должен привести значение свойства IBackgroundTaskInstance.TriggerDetails к WiFiOnDemandHotspotConnectTriggerDetails.

Примечание

Если вы хотите использовать этот API в приложении UWP и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (возможность сети по запросу). Дополнительные сведения см. в разделе Пользовательские возможности.

Возможность сети по запросу будет доступна только разработчикам приложений, создающим комплексные сценарии Wi-Fi хот-спотов между аппаратным устройством с поддержкой привязки и компьютером с Windows.

WiFiOnDemandHotspotUpdateMetadataTrigger

Представляет событие, которое вызывает выполнение фоновой задачи при открытии операционной системы (ОС) Wi-Fi списке сети, как если бы для подключения к новой Wi-Fi сети.

Примечание

Если вы хотите использовать этот API в приложении UWP и опубликовать приложение в Microsoft Store, вам потребуется запросить специальное утверждение для использования пользовательской возможности Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (возможность сети по запросу). Дополнительные сведения см. в разделе Пользовательские возможности.

Возможность сети по запросу будет доступна только разработчикам приложений, создающим комплексные сценарии Wi-Fi хот-спотов между аппаратным устройством с поддержкой привязки и компьютером с Windows.

Интерфейсы

IBackgroundCondition

Используется для принудительного применения типа объекта условия системы.

IBackgroundTask

Предоставляет метод для выполнения работы фоновой задачи.

IBackgroundTaskInstance

Предоставляет доступ к экземпляру фоновой задачи.

IBackgroundTaskInstance2

Предоставляет доступ к экземпляру фоновой задачи. Наследует от интерфейса IBackgroundTaskInstance и добавляет метод GetThrottleCount .

IBackgroundTaskInstance4

Предоставляет доступ к экземпляру фоновой задачи, включая сведения о пользователе.

IBackgroundTaskRegistration

Предоставляет доступ к зарегистрированной фоновой задаче.

IBackgroundTaskRegistration2

Предоставляет доступ к зарегистрированной фоновой задаче. Наследует от интерфейса IBackgroundTaskRegistration и добавляет свойство Trigger .

IBackgroundTaskRegistration3

Представляет фоновую задачу, зарегистрированную в составе группы связанных фоновых задач.

IBackgroundTrigger

Представляет базовый интерфейс для событий триггера.

Перечисления

AlarmAccessStatus

Указывает, предоставил ли пользователь приложению разрешение на настройку оповещений.

ApplicationTriggerResult

Результат запроса на активацию фоновой задачи. Метод RequestAsync возвращает значение этого типа перечисления.

BackgroundAccessRequestKind

Указывает уровень фоновой активности, которую может запрашивать приложение.

BackgroundAccessStatus

Это перечисление указывает возможность приложения выполнять фоновые действия.

Приложения должны успешно вызывать BackgroundExecutionManager.RequestAccessAsync перед регистрацией фоновых задач.

BackgroundTaskCancellationReason

Указывает причины отмены фоновой задачи.

BackgroundTaskThrottleCounter

Указывает тип счетчика регулирования, для проверка в запросе GetThrottleCount.

BackgroundWorkCostValue

Указывает текущие затраты на выполнение фоновой работы. Используется в качестве подсказки для фоновых задач о том, сколько работы они могут выполнить.

CustomSystemEventTriggerRecurrence

Указывает, когда может быть активирован CustomSystemEventTrigger .

DeviceTriggerResult

Указывает, разрешена или запрещена операция фоновой задачи устройства, а также указывает, была ли она отклонена, указывает причину.

EnergyUseLevel

Позволяет приложению планировать фоновые задачи для запуска кода приложения, даже если приложение приостановлено.

Фоновые задачи предназначены для небольших рабочих элементов, не требующих взаимодействия с пользователем, или для обработки всплывающих действий. Сценарии, подходящие для фоновых задач, включают загрузку почты, отображение всплывающего уведомления для входящего сообщения чата или реагирование на изменение состояния системы.

Инструкции по реализации фоновых задач см. в статье Поддержка приложения с помощью фоновых задач (с помощью JavaScript и HTML) или Поддержка приложения с помощью фоновых задач . Пример кода, демонстрирующего реализацию фоновых задач, см. в разделе Пример фоновой задачи.

LocationTriggerType

Указывает тип события расположения для триггера фоновой задачи расположения.

MediaProcessingTriggerResult

Указывает результат вызова MediaProcessingTrigger.RequestAsync.

SystemConditionType

Указывает системное условие, которое должно действовать для выполнения фоновой задачи. Если активируется фоновая задача с условием системы, она не будет выполняться до тех пор, пока условие не будет выполнено.

SystemTriggerType

Указывает системные события, которые можно использовать для запуска фоновой задачи.

Делегаты

BackgroundTaskCanceledEventHandler

Представляет метод, обрабатывающий отмену фоновой задачи.

BackgroundTaskCompletedEventHandler

Представляет метод, обрабатывающий события завершения для фоновой задачи.

BackgroundTaskProgressEventHandler

Представляет метод, обрабатывающий события обновления хода выполнения для фоновой задачи.

См. также раздел