cameraDevice QML Value Type
Beschreibt ein Kameragerät. Mehr...
| Import Statement: | import QtMultimedia |
| In C++: | QCameraDevice |
Eigenschaften
- correctionAngle : QtVideo::Rotation
(since 6.7) - description : string
- id : string
- isDefault : bool
- position : enumeration
- videoFormats : CameraFormat
Detaillierte Beschreibung
Der Wertetyp cameraDevice beschreibt die Eigenschaften eines an das System angeschlossenen Kamerageräts.
Die cameraDevice-Instanz behält ihre Eigenschaften während ihrer gesamten Lebensdauer bei, auch wenn das entsprechende physische Gerät getrennt wird oder seine Einstellungen geändert werden. Um die aktualisierten Eigenschaften im Auge zu behalten, sollte der Benutzer neue Instanzen von cameraDevice von MediaDevices laden, wenn die entsprechenden Signale ausgelöst werden.
Zwei cameraDevice-Instanzen können auf Gleichheit verglichen werden. Sie gelten als gleich, wenn sie dasselbe physische Gerät darstellen, unabhängig davon, ob ihre Eigenschaften gleich oder aktuell sind.
Die Liste der Kamerageräte kann über den Typ MediaDevices abgefragt werden. Um ein bestimmtes Kameragerät auszuwählen, setzen Sie es als Gerät auf Camera.
CaptureSession {
camera: Camera {
cameraDevice: mediaDevices.defaultVideoInput
}
}
MediaDevices {
id: mediaDevices
}Eigenschaft Dokumentation
correctionAngle : QtVideo::Rotation [read-only, since 6.7]
Gibt den Drehwinkel zurück, der erforderlich ist, um die physische Kameradrehung der Kamera im Vergleich zu ihrer ursprünglichen Ausrichtung auszugleichen. Mit anderen Worten: Die Eigenschaft stellt den Winkel im Uhrzeigersinn dar, um den das Ausgabebild gedreht werden muss, um auf dem Bildschirm des Geräts in seiner nativen Ausrichtung aufrecht zu stehen. Da correctionAngle sich auf die ursprüngliche Ausrichtung bezieht, ändert sich dieser Wert nicht, wenn die Ausrichtung des Geräts (Hochformat/Landschaft) geändert wird. Der Korrekturwinkel kann ungleich Null sein, vor allem unter Android, wo die native Ausrichtung und die Kameraausrichtung vom Hersteller definiert werden.

Diese Eigenschaft wurde in Qt 6.7 eingeführt.
description : string [read-only]
Enthält einen von Menschen lesbaren Namen der Kamera.
Verwenden Sie diese Zeichenfolge, um das Gerät dem Benutzer vorzustellen.
id : string [read-only]
Enthält die Geräte-ID der Kamera
Dies ist eine eindeutige ID zur Identifizierung der Kamera, die möglicherweise nicht von Menschen gelesen werden kann.
isDefault : bool [read-only]
Ist wahr, wenn dies das Standard-Kameragerät ist.
position : enumeration [read-only]
Gibt die physische Position der Kamera auf dem Hardwaresystem zurück.
Der zurückgegebene Wert kann einer der folgenden sein:
| Konstante | Beschreibung |
|---|---|
cameraDevice.UnspecifiedPosition | Die Kameraposition ist nicht spezifiziert oder unbekannt. |
cameraDevice.BackFace | Die Kamera befindet sich auf der Rückseite der Systemhardware. Bei einem mobilen Gerät bedeutet dies beispielsweise, dass sie sich auf der dem Bildschirm gegenüberliegenden Seite befindet. |
cameraDevice.FrontFace | Die Kamera befindet sich auf der Vorderseite der Systemhardware. Bei einem mobilen Gerät bedeutet dies, dass sie sich auf der gleichen Seite wie der Bildschirm befindet. Die Vorschau von nach vorne gerichteten Kameras wird um die vertikale Achse gedreht, um die Videoausgabe spiegelverkehrt darzustellen, während diese Drehung bei der Aufnahme nicht erfolgt. |
videoFormats : CameraFormat [read-only]
Enthält die von der Kamera unterstützten Videoformate.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.