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	取得人類存在感測器的唯一裝置標識碼。
IsEngagementSupported	取得人類目前狀態感測器是否能夠察覺使用者是否參與 (查看其計算機) 。
IsPresenceSupported	取得人類目前狀態感測器是否能夠察覺使用者是否在電腦前面。
MaxDetectableDistanceInMillimeters	取得人類存在感測器可以偵測到使用者的最大距離。
MinDetectableDistanceInMillimeters	取得人類存在感測器可以偵測到使用者的最小距離。

方法

FromId(String)	同步擷取與所提供裝置標識碼相關聯的人類存在感測器參考。
FromIdAsync(String)	以異步方式擷取與所提供裝置標識符相關聯的人類存在感測器參考。
GetCurrentReading()	從人類存在感測器擷取目前的感測器讀取。
GetDefault()	同步擷取預設人類存在感測器的參考。
GetDefaultAsync()	以異步方式擷取預設人類存在感測器的參考。
GetDeviceSelector()	擷取用來列舉可用人類存在感測器的進階查詢語法 (AQS) 字串。

事件

ReadingChanged

每當人類存在感測器讀取發生重大變更時就會發生。

另請參閱

• HumanPresenceSensorReading
• HumanPresenceFeatures
• HumanPresenceSettings