cameraDevice QML Value Type
Describe un dispositivo de cámara. Más...
| Import Statement: | import QtMultimedia |
| In C++: | QCameraDevice |
Propiedades
- correctionAngle : QtVideo::Rotation
(since 6.7) - description : string
- id : string
- isDefault : bool
- position : enumeration
- videoFormats : CameraFormat
Descripción detallada
El tipo de valor cameraDevice describe las propiedades de un dispositivo de cámara conectado al sistema.
La instancia cameraDevice conserva sus propiedades durante toda su vida útil, incluso si el dispositivo físico correspondiente se desconecta o se modifica su configuración. Para realizar un seguimiento de las propiedades actualizadas, el usuario debe cargar nuevas instancias de cameraDevice desde MediaDevices cuando se disparen las señales relevantes.
Dos instancias de cameraDevice pueden compararse para comprobar su igualdad. Se consideran iguales si representan el mismo dispositivo físico, independientemente de si sus propiedades son iguales o están actualizadas.
La lista de dispositivos de cámara puede consultarse desde el tipo MediaDevices. Para seleccionar un determinado dispositivo de cámara, configúrelo como dispositivo en Camera.
CaptureSession {
camera: Camera {
cameraDevice: mediaDevices.defaultVideoInput
}
}
MediaDevices {
id: mediaDevices
}Documentación de propiedades
correctionAngle : QtVideo::Rotation [read-only, since 6.7]
Devuelve el ángulo de rotación necesario para compensar la rotación física de la cámara con respecto a su orientación nativa. En otras palabras, la propiedad representa el ángulo en el sentido de las agujas del reloj por el que se debe girar la imagen de salida para que quede vertical en la pantalla del dispositivo en su orientación nativa. Dado que correctionAngle es relativo a la orientación nativa, este valor no cambia al alterar la orientación del dispositivo (retrato/paisaje). El ángulo de corrección puede ser distinto de cero sobre todo en Android, donde las orientaciones nativa y de la cámara son definidas por el fabricante.
Esta propiedad se introdujo en Qt 6.7.
description : string [read-only]
Contiene un nombre legible de la cámara.
Utilice esta cadena para presentar el dispositivo al usuario.
id : string [read-only]
Contiene el identificador de dispositivo de la cámara
Se trata de un ID único para identificar la cámara y puede no ser legible por humanos.
isDefault : bool [read-only]
Es true si este es el dispositivo de cámara por defecto.
position : enumeration [read-only]
Devuelve la posición física de la cámara en el sistema de hardware.
El valor devuelto puede ser uno de los siguientes
| Constante | Descripción |
|---|---|
cameraDevice.UnspecifiedPosition | La posición de la cámara no está especificada o es desconocida. |
cameraDevice.BackFace | La cámara está en la cara posterior del hardware del sistema. Por ejemplo, en un dispositivo móvil, significa que está en el lado opuesto al de la pantalla. |
cameraDevice.FrontFace | La cámara está en la cara frontal del hardware del sistema. Por ejemplo en un dispositivo móvil, significa que está en el mismo lado que el de la pantalla. La vista previa de las cámaras frontales se voltea alrededor del eje vertical para mostrar la salida de vídeo como un espejo, mientras que este volteo no se realiza durante la grabación. |
videoFormats : CameraFormat [read-only]
Contiene los formatos de vídeo compatibles con la cámara.
© 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.
