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 |
Это перечисление указывает возможность приложения выполнять фоновые действия.
|
BackgroundTaskCancellationReason |
Указывает причины отмены фоновой задачи. |
BackgroundTaskThrottleCounter |
Указывает тип счетчика регулирования, для проверка в запросе GetThrottleCount. |
BackgroundWorkCostValue |
Указывает текущие затраты на выполнение фоновой работы. Используется в качестве подсказки для фоновых задач о том, сколько работы они могут выполнить. |
CustomSystemEventTriggerRecurrence |
Указывает, когда может быть активирован CustomSystemEventTrigger . |
DeviceTriggerResult |
Указывает, разрешена или запрещена операция фоновой задачи устройства, а также указывает, была ли она отклонена, указывает причину. |
EnergyUseLevel |
Позволяет приложению планировать фоновые задачи для запуска кода приложения, даже если приложение приостановлено. Фоновые задачи предназначены для небольших рабочих элементов, не требующих взаимодействия с пользователем, или для обработки всплывающих действий. Сценарии, подходящие для фоновых задач, включают загрузку почты, отображение всплывающего уведомления для входящего сообщения чата или реагирование на изменение состояния системы. Инструкции по реализации фоновых задач см. в статье Поддержка приложения с помощью фоновых задач (с помощью JavaScript и HTML) или Поддержка приложения с помощью фоновых задач . Пример кода, демонстрирующего реализацию фоновых задач, см. в разделе Пример фоновой задачи. |
LocationTriggerType |
Указывает тип события расположения для триггера фоновой задачи расположения. |
MediaProcessingTriggerResult |
Указывает результат вызова MediaProcessingTrigger.RequestAsync. |
SystemConditionType |
Указывает системное условие, которое должно действовать для выполнения фоновой задачи. Если активируется фоновая задача с условием системы, она не будет выполняться до тех пор, пока условие не будет выполнено. |
SystemTriggerType |
Указывает системные события, которые можно использовать для запуска фоновой задачи. |
Делегаты
BackgroundTaskCanceledEventHandler |
Представляет метод, обрабатывающий отмену фоновой задачи. |
BackgroundTaskCompletedEventHandler |
Представляет метод, обрабатывающий события завершения для фоновой задачи. |
BackgroundTaskProgressEventHandler |
Представляет метод, обрабатывающий события обновления хода выполнения для фоновой задачи. |