En esta página

cameraDevice QML Value Type

Describe un dispositivo de cámara. Más...

Import Statement: import QtMultimedia
In C++: QCameraDevice

Propiedades

Descripción detallada

El tipo de valor «cameraDevice» describe las propiedades de un dispositivo de cámara conectado al sistema.

La instancia de `cameraDevice` conserva sus propiedades durante todo su ciclo de vida, incluso si el dispositivo físico correspondiente se desconecta o se modifican sus ajustes. Para realizar un seguimiento de las propiedades actualizadas, el usuario debe cargar nuevas instancias de `cameraDevice` desde ` MediaDevices ` cuando se activen las señales pertinentes.

Se pueden comparar dos instancias de «cameraDevice» para determinar si son iguales. 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 se puede consultar a través del tipo ` MediaDevices `. Para seleccionar un dispositivo de cámara concreto, configúralo 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, esta propiedad representa el ángulo en el sentido de las agujas del reloj en el que debe girarse la imagen de salida para que aparezca en posición vertical en la pantalla del dispositivo, con su orientación nativa. Dado que ` correctionAngle ` es relativo a la orientación nativa, este valor no cambia al modificar la orientación del dispositivo (vertical/horizontal). El ángulo de corrección puede ser distinto de cero, sobre todo en Android, donde las orientaciones nativa y de la cámara las define el fabricante.

Ejemplo con 90 grados \a correctionAngle

Esta propiedad se introdujo en Qt 6.7.

description : string [read-only]

Contiene un nombre legible para el usuario de la cámara.

Utiliza esta cadena para presentar el dispositivo al usuario.

id : string [read-only]

Contiene el identificador del dispositivo de la cámara

Se trata de un identificador único que permite identificar la cámara y puede que no sea legible para el ser humano.

isDefault : bool [read-only]

Es cierto si este es el dispositivo de cámara predeterminado.

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:

ConstanteDescripción
cameraDevice.UnspecifiedPositionLa posición de la cámara no está especificada o se desconoce.
cameraDevice.BackFaceLa cámara se encuentra en la parte trasera del hardware del sistema. Por ejemplo, en un dispositivo móvil, significa que está en el lado opuesto al de la pantalla.
cameraDevice.FrontFaceLa cámara se encuentra en la cara frontal del hardware del sistema. Por ejemplo, en un dispositivo móvil, significa que está en el mismo lado que la pantalla. La vista previa de las cámaras frontales se invierte alrededor del eje vertical para mostrar la salida de vídeo como un espejo, mientras que esta inversión no se realiza durante la grabación.

videoFormats : CameraFormat [read-only]

Muestra 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.