HumanPresenceSensor 类

定义

命名空间:

Windows.Devices.Sensors

表示一个传感器，该传感器检测用户是存在、不在，还是未与其设备交互。

public ref class HumanPresenceSensor sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 983040)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class HumanPresenceSensor final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 983040)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class HumanPresenceSensor

Public NotInheritable Class HumanPresenceSensor

继承

Object Platform::Object IInspectable HumanPresenceSensor

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 11 Insider Preview (在 10.0.23504.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v15.0 中引入)

注解

状态检测可能会对安全性、响应能力和性能产生重大影响。

• 在无人参与的情况下，可以自动锁定设备，以保护敏感文件和其他信息。
• 可以推断用户意向，以缩短从检测到身份验证或交互所需的响应时间。
• 通过减少不必要的屏幕空闲时间，可以延长电池使用时间。

属性

DeviceId	获取人类状态传感器的唯一设备 ID。
IsEngagementSupported	获取人类状态传感器是否能够感知用户是否参与 (查看其电脑) 。
IsPresenceSupported	获取人类状态传感器是否能够感知用户是否在电脑前。
MaxDetectableDistanceInMillimeters	获取人类状态传感器可以检测到用户的最大距离。
MinDetectableDistanceInMillimeters	获取人类存在传感器可以检测到用户的最小距离。

方法

FromId(String)	同步检索与所提供的设备 ID 关联的人类存在传感器的引用。
FromIdAsync(String)	异步检索对与提供的设备 ID 关联的人类存在传感器的引用。
GetCurrentReading()	从人类存在传感器检索当前传感器读数。
GetDefault()	同步检索对默认人类存在传感器的引用。
GetDefaultAsync()	异步检索对默认人类存在传感器的引用。
GetDeviceSelector()	检索用于枚举可用人类存在传感器的 AQS) 字符串 (高级查询语法。

事件

ReadingChanged

每当人类存在传感器读数发生重大变化时发生。

另请参阅

• HumanPresenceSensorReading
• HumanPresenceFeatures
• HumanPresenceSettings