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

カメラ デバイスのオクルージョン状態が変更されたときに発生します。

適用対象

こちらもご覧ください