Partager via


CameraOcclusionInfo Classe

Définition

Fournit des informations sur l’état d’occlusion d’un appareil photo.

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
Héritage
Object Platform::Object IInspectable CameraOcclusionInfo
Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 11 (introduit dans 10.0.22000.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v14.0)

Remarques

De nombreux appareils fournissent des mécanismes, tels qu’un obturateur mécanique, qui permettent à l’utilisateur d’obstruer l’appareil photo pour la confidentialité. D’autres appareils peuvent obstruer la caméra dans certaines postures. Cette interface permet aux applications de recevoir des notifications lorsque l’état d’occlusion de la caméra change afin qu’elles puissent désactiver ou modifier leur comportement de capture de caméra lorsque la caméra est obstruée.

Obtenez une instance de cette classe en accédant à la propriété CameraOcclusionInfo du VideoDeviceController associé à la caméra.

Vous devez uniquement utiliser les données d’état d’obturation représentées par cette classe lorsque la caméra est activement en streaming. Les applications doivent répondre de manière logique lorsqu’elles détectent que l’obturateur est fermé. Cela doit inclure un message dans l’application pour ouvrir l’obturateur. Les applications ne doivent pas effectuer automatiquement une action (par exemple, éteindre l’appareil photo) ou empêcher l’utilisateur d’effectuer une action (par exemple, allumer la caméra) en fonction de l’état de l’obturateur, car toutes les caméras ne signalent pas de manière fiable l’état d’obturation lorsqu’elles ne sont pas diffusées en continu. Les applications ne doivent pas traiter l’état d’obturation signalé comme un indicateur de confidentialité absolu. Il s’agit uniquement d’une notification indiquant que l’appareil photo croit que le déclencheur est fermé.

Méthodes

GetState()

Obtient l’état d’occlusion actuel de l’appareil photo.

IsOcclusionKindSupported(CameraOcclusionKind)

Obtient une valeur booléenne indiquant si le type d’occlusion spécifié est pris en charge par l’appareil photo.

Événements

StateChanged

Déclenché lorsque l’état d’occlusion de l’appareil photo change.

S’applique à

Voir aussi