DeviceUseTrigger 类

定义

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

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

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

重要

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

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

public ref class DeviceUseTrigger sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class DeviceUseTrigger final
/// [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 DeviceUseTrigger final
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class DeviceUseTrigger
[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 DeviceUseTrigger
function DeviceUseTrigger()
Public NotInheritable Class DeviceUseTrigger
继承
Object Platform::Object IInspectable DeviceUseTrigger
属性
实现

Windows 要求

设备系列
Windows 10 (在 10.0.10240.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

有关策略要求的详细信息,请参阅 从后台任务访问传感器和设备

应用在手机上触发后台任务之前,必须先调用 BackgroundExecutionManager.RequestAccessAsync 以检查应用是否能够请求后台任务。 当你的应用在电脑上运行时,不需要此检查。

构造函数

DeviceUseTrigger()

DeviceUseTrigger 的构造函数。 不采用任何参数。

方法

RequestAsync(String)

触发后台任务并返回 DeviceTriggerResult ,指示触发器请求成功或失败。 获取后台任务将访问的设备或传感器 的 DeviceInformation.ID

RequestAsync(String, String)

触发后台任务并返回 DeviceTriggerResult ,指示触发器请求成功或失败。 获取后台任务将访问的设备或传感器 DeviceInformation.ID ,以及传递给后台任务的可选特定于应用的字符串,以标识要执行的操作。

适用于

另请参阅