Windows.ApplicationModel.Background 命名空间

使应用能够计划后台任务以运行应用代码,即使应用暂停也是如此。

后台任务适用于不需要用户交互或处理 Toast 操作的小型工作项。 适用于后台任务的方案包括下载邮件、显示传入聊天消息的 Toast 通知或响应系统条件中的更改。

有关实现后台任务的指导,请参阅 使用 JavaScript 和 HTML ( 支持 应用) 或支持具有后台任务 的应用。 有关如何实现后台任务的示例代码,请参阅 后台任务示例

ActivitySensorTrigger

表示 在 ActivitySensor 接收输入时激活的触发器。 当应用程序需要响应活动传感器时,将使用此功能。

AlarmApplicationManager

请求用户设置警报的权限,并检索应用设置警报的用户权限的状态。

AppBroadcastTrigger

表示一个事件,该事件触发后台任务在应用程序启动游戏广播时运行。

AppBroadcastTriggerProviderInfo

提供有关正在广播游戏的应用程序的信息,例如其徽标、显示名称和视频特征。

ApplicationTrigger

这样,可以从应用程序中以编程方式触发后台任务。

ApplicationTriggerDetails

ApplicationTrigger 的详细信息。

AppointmentStoreNotificationTrigger

表示启动后台任务的触发器,用于处理对约会存储的更改。

BackgroundExecutionManager

管理运行后台任务的权限。

BackgroundTaskBuilder

表示向系统注册的后台任务。

BackgroundTaskCompletedEventArgs

表示发送完成通知时任务的完成信息。

BackgroundTaskDeferral

表示 IBackgroundTaskInstance.GetDeferral 方法返回的后台任务延迟。

BackgroundTaskProgressEventArgs

表示发送进度更新通知时任务的进度信息。

BackgroundTaskRegistration

表示已向系统注册的后台任务。

BackgroundTaskRegistrationGroup

提供分组语义,以便可以单独维护后台任务注册。

BackgroundWorkCost

检索有关后台任务资源可用性的提示。 后台任务可以使用此提示来确定激活时要执行的操作。

BluetoothLEAdvertisementPublisherTrigger

表示注册以在后台播发蓝牙 LE 播发的触发器。

BluetoothLEAdvertisementWatcherTrigger

表示注册以在后台扫描蓝牙 LE 播发的触发器。

CachedFileUpdaterTrigger

表示启动后台任务的触发器,以启用缓存文件更新程序协定。

CachedFileUpdaterTriggerDetails

提供有关调用触发器的缓存文件操作的详细信息。

ChatMessageNotificationTrigger

表示在有短信通知时激活的触发器。

ChatMessageReceivedNotificationTrigger

表示启动后台任务的触发器,用于处理可能需要根据其内容筛选的任何传入消息。 有关筛选消息的详细信息,请参阅 Windows.ApplicationModel.CommunicationBlocking

CommunicationBlockingAppSetAsActiveTrigger

表示在选择为首选阻止应用时激活通信阻止应用程序的触发器。

用户一次可以安装多个阻止应用程序的通信。 此触发器用于让应用程序知道它已被选为活动通信阻止应用程序。 有关通信阻止 API 的详细信息,请参阅 Windows.ApplicationModel.CommunicationBlocking

ContactStoreNotificationTrigger

表示启动后台任务的触发器,用于处理对联系人存储的更改。

ContentPrefetchTrigger

提供预提取 Web 资源时运行自定义处理程序的功能。

ConversationalAgentTrigger

表示启动后台任务的触发器,用于通过 Windows 平台代理激活运行时 (AAR) 处理数字助理通信。

CustomSystemEventTrigger

此类允许指定自定义系统触发器,以便在系统触发时注册并响应它。

DeviceConnectionChangeTrigger

表示在设备连接状态发生更改时启动后台任务的触发器。

DeviceManufacturerNotificationTrigger

表示启动后台任务的触发器,以启用设备制造商操作。

DeviceServicingTrigger

表示应用程序可以触发的事件,以启动设备 (固件或设置) 长时间运行的更新。

Windows 8.1使你可以为通过 USB、HID 和蓝牙进行通信的外围设备开发 UWP 应用。 例如,用户可能需要将电脑上的内容同步到设备或从设备同步,或者对设备本身执行长时间运行的更新,例如设置或固件更新。 Windows 8.1提供两个后台任务和相应的 API,允许设备在后台同步和更新:DeviceServicingTrigger 和 DeviceUseTrigger。 本主题提供 DeviceServicingTrigger 的 API 参考信息 - 有关在设备应用的上下文中使用此触发器的信息,请参阅 UWP 设备应用的设备同步和更新

DeviceServicingTrigger 后台任务允许与外围设备交互的 UWP 应用在应用挂起时执行长时间运行的设备更新,例如设置传输或固件更新。 每次使用后台任务时,更新后台设备都需要用户批准。 与 DeviceUseTrigger 后台任务不同,DeviceServicingTrigger 后台任务允许设备重启和断开连接,并允许最多 30 分钟的后台活动。

重要

此触发器不能与单进程后台任务一起使用。

DeviceUseTrigger

表示Windows 运行时应用可以触发的事件,以使用设备或传感器启动长时间运行的操作。

DeviceUseTrigger 允许你的Windows 运行时应用访问后台的传感器和外围设备,即使前台应用暂停也是如此。 例如,根据应用运行所在的位置,它可以使用后台任务将数据与设备或监视器传感器同步。

此类可用于 UWP 应用和 Windows Phone 8.x 应用。 但是, DeviceUseTrigger 后台任务支持不同的 API,并且受不同的策略的约束,具体取决于它运行 (电脑或手机) 的位置。 若要详细了解这些差异,请参阅 从后台任务访问传感器和设备

重要

此触发器不能与单进程后台任务一起使用。

有关演示如何在电脑上使用 DeviceUseTrigger 的示例,请参阅 自定义 USB 设备示例。 有关手机示例,请参阅 后台传感器示例

DeviceWatcherTrigger

表示导致后台任务在设备列表发生更改时运行的事件。 由 GetBackgroundTrigger 返回。

EmailStoreNotificationTrigger

表示一个触发器,该触发器允许通知对电子邮件存储所做的更改。

GattCharacteristicNotificationTrigger

表示在收到传入更改通知时为蓝牙 LE GATT 特征启动后台任务的触发器。

GattServiceProviderTrigger

构造一个泛型属性 (GATT) 服务,该服务可以保留在后台。

GattServiceProviderTriggerResult

此类包含 GattServiceProviderTrigger.CreateAsync () 创建的触发器。

GeovisitTrigger

表示触发与访问相关的后台任务的事件。

LocationTrigger

表示触发后台任务的位置事件。 这用于地理围栏。

MaintenanceTrigger

表示维护触发器。

MediaProcessingTrigger

表示启动用于执行媒体处理的后台任务的触发器。

MobileBroadbandDeviceServiceNotificationTrigger

表示在网络发送 SIM 工具命令时激活的触发器。 接收此通知的应用然后处理 SIM 工具命令。

此功能仅适用于移动运营商应用和 UWP 应用,由移动网络运营商授予特权访问权限。 有关详细信息,请参阅移动宽带:

MobileBroadbandPcoDataChangeTrigger

表示一个手机网络协议配置选项更改事件,该事件触发要运行的后台任务。

MobileBroadbandPinLockStateChangeTrigger

表示一个触发器,该触发器指示 SIM PIN 锁状态何时发生更改。

此功能仅适用于移动运营商应用和 UWP 应用,由移动网络运营商授予特权访问权限。 有关详细信息,请参阅移动宽带:

MobileBroadbandRadioStateChangeTrigger

表示一个触发器,该触发器指示移动宽带无线电状态何时发生更改。 例如,当移动设备转换到飞行模式或从飞行模式转换时,此触发器将激活。

此功能仅适用于移动运营商应用和 UWP 应用,由移动网络运营商授予特权访问权限。 有关详细信息,请参阅移动宽带:

MobileBroadbandRegistrationStateChangeTrigger

表示一个触发器,该触发器指示移动宽带注册状态何时发生更改。 例如,当移动设备转换到漫游或从漫游转换时,此触发器将激活。

此功能仅适用于移动运营商应用和 UWP 应用,由移动网络运营商授予特权访问权限。 有关详细信息,请参阅移动宽带:

NetworkOperatorDataUsageTrigger

表示一个触发器,当本地数据计数器估计在移动宽带接口上发送和接收) 的使用情况 (字节已由可操作阈值更改时启动后台任务的触发器。

注意

此功能仅适用于移动运营商授予特权访问权限的移动运营商应用和 UWP 应用。

如果想要使用此 API 并将应用发布到应用商店,则需要特殊批准。 有关详细信息,请参阅应用功能声明移动宽带下的“特殊和受限功能”部分。

NetworkOperatorHotspotAuthenticationTrigger

表示移动网络运营商热点身份验证触发器。

注意

应用只能在预配了引用此应用来处理热点身份验证的 WLAN 配置文件后实例化此对象并注册热点身份验证事件。 有关详细信息,请参阅无线热点操作员的Windows 8集成

NetworkOperatorNotificationTrigger

表示移动网络运营商通知触发器。

PaymentAppCanMakePaymentTrigger

此类表示 PaymentAppCanMakePayment 触发器。

PhoneTrigger

表示触发后台任务的电话事件。

PushNotificationTrigger

表示一个对象,该对象调用应用上的后台工作项以响应 原始通知的接收。

RcsEndUserMessageAvailableTrigger

表示当新的富通信服务 (RCS) 消息可用时启动后台任务的触发器。

RfcommConnectionTrigger

表示在建立 RFCOMM 入站或出站连接时启动后台任务的触发器。

SecondaryAuthenticationFactorAuthenticationTrigger

表示代表配套设备启动后台任务的触发器。

SensorDataThresholdTrigger

表示在越过传感器阈值限制时响应的触发器。

SmartCardTrigger

表示智能卡触发的事件。

SmsMessageReceivedTrigger

表示在短信到达时引发的触发器。

SocketActivityTrigger

表示启动用于处理套接字活动的后台任务的触发器。

StorageLibraryChangeTrackerTrigger

表示 StorageFolder 中的文件更改,该更改触发要运行的后台任务。

StorageLibraryContentChangedTrigger

创建在指定库中更改文件时触发的触发器。

SystemCondition

表示一个系统条件,该条件必须生效才能运行后台任务。

SystemTrigger

表示触发后台任务运行的系统事件。

TetheringEntitlementCheckTrigger

表示触发后台任务运行的连接事件。

TimeTrigger

表示触发后台任务运行的时间事件。

ToastNotificationActionTrigger

表示当用户对交互式 Toast 通知执行操作时导致后台任务运行的事件。

ToastNotificationHistoryChangedTrigger

表示一个事件,当清除应用的 Toast 通知历史记录、将一个或多个 Toast 通知添加到应用通知历史记录或从应用的通知历史记录中删除时,或者当应用的一个或多个 Toast 通知过期并且从通知历史记录中删除时,导致后台任务运行。

UserNotificationChangedTrigger

表示在添加或删除 UserNotification 时触发的触发器。

WiFiOnDemandHotspotConnectTrigger

使应用能够计划后台任务以运行应用代码,即使应用暂停也是如此。

后台任务适用于不需要用户交互或处理 Toast 操作的小型工作项。 适用于后台任务的方案包括下载邮件、显示传入聊天消息的 Toast 通知或响应系统条件中的更改。

有关实现后台任务的指导,请参阅 使用 JavaScript 和 HTML ( 支持 应用) 或支持具有后台任务 的应用。 有关如何实现后台任务的示例代码,请参阅 后台任务示例

WiFiOnDemandHotspotUpdateMetadataTrigger

使应用能够计划后台任务以运行应用代码,即使应用暂停也是如此。

后台任务适用于不需要用户交互或处理 Toast 操作的小型工作项。 适用于后台任务的方案包括下载邮件、显示传入聊天消息的 Toast 通知或响应系统条件中的更改。

有关实现后台任务的指导,请参阅 使用 JavaScript 和 HTML ( 支持 应用) 或支持具有后台任务 的应用。 有关如何实现后台任务的示例代码,请参阅 后台任务示例

结构

BackgroundAlarmApplicationContract

使应用能够计划后台任务以运行应用代码,即使应用暂停也是如此。

后台任务适用于不需要用户交互或处理 Toast 操作的小型工作项。 适用于后台任务的方案包括下载邮件、显示传入聊天消息的 Toast 通知或响应系统条件中的更改。

有关实现后台任务的指导,请参阅 使用 JavaScript 和 HTML ( 支持 应用) 或支持具有后台任务 的应用。 有关如何实现后台任务的示例代码,请参阅 后台任务示例

接口

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

指示设备后台任务操作是允许还是被拒绝,如果它被拒绝,则指定原因。

LocationTriggerType

指示位置后台任务触发器的位置事件类型。

MediaProcessingTriggerResult

指定对 MediaProcessingTrigger.RequestAsync 的调用的结果。

SystemConditionType

指定一个系统条件,该条件必须生效才能运行后台任务。 如果触发了具有系统条件的后台任务,则在满足条件之前,该任务将不会运行。

SystemTriggerType

指定可用于触发后台任务的系统事件。

委托

BackgroundTaskCanceledEventHandler

表示处理后台任务取消的方法。

BackgroundTaskCompletedEventHandler

表示处理后台任务的完成事件的方法。

BackgroundTaskProgressEventHandler

表示处理后台任务的进度更新事件的方法。

另请参阅