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 속성에 액세스하여 이 클래스의 instance 가져옵니다.

카메라가 적극적으로 스트리밍되는 동안에는 이 클래스가 나타내는 셔터 상태 데이터만 사용해야 합니다. 앱은 셔터가 닫힌 것을 감지할 때 논리적으로 응답해야 합니다. 여기에는 셔터를 여는 앱 내 메시지가 포함되어야 합니다. 모든 카메라가 스트리밍하지 않을 때 셔터 상태를 안정적으로 보고하지 않기 때문에 응용 프로그램에서 자동으로 작업을 수행(예: 카메라 끄기)하거나 사용자가 셔터 상태에 따라 작업을 수행하지 못하도록 차단해서는 안 됩니다.(예: 카메라 켜기). 애플리케이션은 보고된 셔터 상태를 절대 개인 정보 보호 지표로 취급해서는 안 됩니다. 이는 카메라가 셔터가 닫혀 있다고 믿는 알림일 뿐입니다.

메서드

GetState()	카메라 디바이스의 현재 폐색 상태를 가져옵니다.
IsOcclusionKindSupported(CameraOcclusionKind)	카메라 디바이스에서 지정된 폐색 종류를 지원하는지 여부를 나타내는 부울 값을 가져옵니다.

이벤트

StateChanged

카메라 디바이스의 폐색 상태가 변경될 때 발생합니다.

추가 정보

• VideoDeviceController