CameraOcclusionInfo Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
- 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. |