通过

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

当相机设备的遮挡状态更改时引发。

适用于

另请参阅