CameraOcclusionInfo クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
カメラ デバイスのオクルージョン状態に関する情報を提供します。
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 CameraOcclusionInfoPublic NotInheritable Class CameraOcclusionInfo- 継承
- 属性
Windows の要件
| デバイス ファミリ |
Windows 11 (10.0.22000.0 で導入)
|
| API contract |
Windows.Foundation.UniversalApiContract (v14.0 で導入)
|
注釈
多くのデバイスには、ユーザーがプライバシーのためにカメラ デバイスを取り込むメカニズム (機械的シャッターなど) が用意されています。 他のデバイスは、特定の姿勢でカメラを遮る可能性があります。 このインターフェイスを使用すると、アプリケーションはカメラのオクルージョン状態が変化したときに通知を受け取ることができるため、カメラがオクルージョンされたときにカメラ キャプチャの動作を無効にしたり変更したりできます。
カメラに関連付けられている VideoDeviceController の CameraOcclusionInfo プロパティにアクセスして、このクラスのインスタンスを取得します。
カメラがアクティブにストリーミングしている間は、このクラスで表されるシャッター状態データのみを使用する必要があります。 アプリは、シャッターが閉じていることを検出したときに論理的な方法で応答する必要があります。 これには、シャッターを開くアプリ内メッセージが含まれている必要があります。 すべてのカメラがストリーミングされていないときにシャッター状態を確実に報告するわけではないので、アプリケーションはシャッター状態に基づいて自動的にアクションを実行したり(カメラをオフにするなど)、ユーザーがシャッター状態に基づいてアクションを実行できないようにする必要があります。 アプリケーションは、報告されたシャッター状態を絶対プライバシーインジケーターとして扱う必要はありません。これは、カメラがシャッターが閉じていると信じているという通知にすぎません。
メソッド
| GetState() |
カメラ デバイスの現在のオクルージョン状態を取得します。 |
| IsOcclusionKindSupported(CameraOcclusionKind) |
指定したオクルージョンの種類がカメラ デバイスでサポートされているかどうかを示すブール値を取得します。 |
イベント
| StateChanged |
カメラ デバイスのオクルージョン状態が変更されたときに発生します。 |