CameraOcclusionInfo 類別

定義

命名空間:

Windows.Media.Devices

提供相機裝置遮蔽狀態的相關資訊。

public ref class CameraOcclusionInfo sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 851968)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class CameraOcclusionInfo final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 851968)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class CameraOcclusionInfo

Public NotInheritable Class CameraOcclusionInfo

繼承

Object Platform::Object IInspectable CameraOcclusionInfo

屬性

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 需求

裝置系列	Windows 11 (已於 10.0.22000.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v14.0 引進)

備註

許多裝置都提供機制，例如機械式快門，可讓使用者遮蔽相機裝置的隱私權。 其他裝置可能會在特定狀態中遮蔽相機。 此介面可讓應用程式在相機的遮蔽狀態變更時接收通知，以便在遮蔽相機時停用或修改相機擷取行為。

藉由存取與相機相關聯之 VideoDeviceController的CameraOcclusionInfo屬性，以取得這個類別的實例。

您應該只在相機主動串流時，才使用這個類別所代表的快門狀態資料。 當應用程式偵測到關閉快門時，應用程式應該以邏輯方式回應。 這應該包含應用程式內訊息，以開啟快門。 應用程式不得在 (自動採取動作，例如關閉相機) 或封鎖使用者執行動作 (例如，根據快門狀態開啟相機) ，因為並非所有相機在未串流時都會可靠地報告快門狀態。 應用程式不得將回報的快門狀態視為絕對隱私權指標 ，它只是相機認為關閉快門的通知。

方法

GetState()	取得相機裝置目前的遮蔽狀態。
IsOcclusionKindSupported(CameraOcclusionKind)	取得布林值，指出相機裝置是否支援指定的遮蔽種類。

事件

StateChanged

當相機裝置的遮蔽狀態變更時引發。

另請參閱

• VideoDeviceController