CameraOcclusionInfo Klasse

  • Referenz

Definition

Namespace:
Windows.Media.Devices
Bearbeiten

Stellt Informationen zum Okklusionszustand eines Kamerageräts bereit.

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
Vererbung
Object Platform::Object IInspectable CameraOcclusionInfo
Attribute
ContractVersionAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Gerätefamilie
Windows 11 (eingeführt in 10.0.22000.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v14.0)

Hinweise

Viele Geräte bieten Mechanismen, z. B. einen mechanischen Verschluss, mit dem der Benutzer das Kameragerät aus Datenschutzgründen verschließen kann. Andere Geräte können die Kamera in bestimmten Haltungen verdecken. Mit dieser Schnittstelle können Anwendungen Benachrichtigungen empfangen, wenn sich der Okklusionszustand der Kamera ändert, sodass sie ihr Kameraaufnahmeverhalten deaktivieren oder ändern können, wenn die Kamera verdeckt ist.

Rufen Sie eine instance dieser Klasse ab, indem Sie auf die CameraOcclusionInfo-Eigenschaft des VideoDeviceController zugreifen, der der Kamera zugeordnet ist.

Sie sollten nur die von dieser Klasse dargestellten Auslösezustandsdaten verwenden, während die Kamera aktiv streamingt. Apps sollten auf logische Weise reagieren, wenn sie erkennen, dass der Auslöser geschlossen ist. Dies sollte eine In-App-Nachricht enthalten, um den Auslöser zu öffnen. Anwendungen dürfen nicht automatisch eine Aktion ausführen (z. B. die Kamera ausschalten) oder den Benutzer daran hindern, eine Aktion auszuführen (z. B. das Einschalten der Kamera), basierend auf dem Auslösezustand, da nicht jede Kamera den Auslösezustand zuverlässig meldet, wenn sie nicht streamingt. Anwendungen dürfen den gemeldeten Auslösezustand nicht als absolute Datenschutzanzeige behandeln – es ist nur eine Benachrichtigung, dass die Kamera glaubt, dass der Auslöser geschlossen ist.

Methoden

GetState()

Ruft den aktuellen Okklusionszustand des Kamerageräts ab.
IsOcclusionKindSupported(CameraOcclusionKind)

Ruft einen booleschen Wert ab, der angibt, ob die angegebene Okklusionsart vom Kameragerät unterstützt wird.

Ereignisse

StateChanged

Wird ausgelöst, wenn sich der Okklusionszustand des Kamerageräts ändert.

Gilt für:

Weitere Informationen