QCameraDevice Class
La clase QCameraDevice proporciona información general sobre los dispositivos de cámara. Más información...
| Encabezado: | #include <QCameraDevice> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Multimedia) target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
| qmake: | QT += multimedia |
| En QML: | cameraDevice |
Tipos públicos
| enum | Position { UnspecifiedPosition, BackFace, FrontFace } |
Propiedades
|
|
Funciones públicas
| QCameraDevice() | |
| QCameraDevice(const QCameraDevice &other) | |
| ~QCameraDevice() | |
| QtVideo::Rotation | correctionAngle() const |
| QString | description() const |
| QByteArray | id() const |
| bool | isDefault() const |
| bool | isNull() const |
| QList<QSize> | photoResolutions() const |
| QCameraDevice::Position | position() const |
| QList<QCameraFormat> | videoFormats() const |
| bool | operator!=(const QCameraDevice &other) const |
| QCameraDevice & | operator=(const QCameraDevice &other) |
| bool | operator==(const QCameraDevice &other) const |
Descripción detallada
QCameraDevice representa un dispositivo de cámara físico y sus propiedades.
Puedes averiguar qué cámaras hay disponibles en un sistema utilizando las funciones availableCameras() y defaultCamera(). Estas se encuentran en QtMultimedia::MediaDevices.
La instancia de QCameraDevice 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 QCameraDevice desde QMediaDevices cuando se activen las señales pertinentes.
Este ejemplo muestra el nombre de todas las cámaras disponibles:
const QList<QCameraDevice> cámaras = QMediaDevices::videoInputs();
for (const QCameraDevice&cameraDevice: cámaras)
qDebug() << cameraDevice.description();Se puede utilizar un `QCameraDevice` para crear un ` QCamera`. En el siguiente ejemplo se crea una instancia de ` QCamera ` cuyo dispositivo de cámara se denomina ` mycamera`:
const QList<QCameraDevice> cameras = QMediaDevices::videoInputs();
for (const QCameraDevice &cameraDevice : cameras) {
if (cameraDevice.description() == "mycamera")
camera = new QCamera(cameraDevice);
}También puedes utilizar QCameraDevice para obtener información general sobre un dispositivo de cámara, como su descripción y su ubicación física en el sistema.
QCamera myCamera;
QCameraDevice cameraDevice = myCamera.cameraDevice();
if (cameraDevice.position()== QCameraDevice::FrontFace)
qDebug() << "The camera is on the front face of the hardware system.";
else if (cameraDevice.position()== QCameraDevice::BackFace)
qDebug() << "The camera is on the back face of the hardware system.";Véase también QCamera.
Documentación sobre los tipos de miembros
enum QCameraDevice::Position
Esta enumeración especifica la posición física de la cámara en el hardware del sistema.
| Constante | Valor | Descripción |
|---|---|---|
QCameraDevice::UnspecifiedPosition | 0 | La posición de la cámara no está especificada o se desconoce. |
QCameraDevice::BackFace | 1 | La 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. |
QCameraDevice::FrontFace | 2 | La 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. Las cámaras frontales generan fotogramas de vídeo con la propiedad « QVideoFrame::mirrored » establecida en « true ». Esto significa que la presentación de estos fotogramas se invierte alrededor del eje vertical para mostrar la salida de vídeo como un reflejo, mientras que la grabación solo tiene en cuenta las transformaciones de la superficie especificadas en « QVideoFrame::surfaceFormat ». |
Véase también ` position()`.
Documentación de la propiedad
[read-only, since 6.7] correctionAngle : const QtVideo::Rotation
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 sentido horario 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.

Esta enumeración se introdujo en Qt 6.7.
Funciones de acceso:
| QtVideo::Rotation | correctionAngle() const |
[read-only] description : const QString
Devuelve la descripción legible para el usuario de la cámara.
Utiliza esta cadena para presentar el dispositivo al usuario.
Funciones de acceso:
| QString | description() const |
[read-only] id : const QByteArray
Devuelve 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 los humanos.
Funciones de acceso:
| QByteArray | id() const |
[read-only] isDefault : const bool
Devuelve «true» si se trata del dispositivo de cámara predeterminado.
Funciones de acceso:
| bool | isDefault() const |
[read-only] position : const Position
Devuelve la posición física de la cámara en el sistema de hardware.
Funciones de acceso:
| QCameraDevice::Position | position() const |
[read-only] videoFormats : const QList<QCameraFormat>
Devuelve los formatos de vídeo compatibles con la cámara.
Funciones de acceso:
| QList<QCameraFormat> | videoFormats() const |
Documentación de las funciones de miembro
QCameraDevice::QCameraDevice()
Crea un dispositivo de cámara nulo
QCameraDevice::QCameraDevice(const QCameraDevice &other)
Crea una copia de other.
[noexcept] QCameraDevice::~QCameraDevice()
Destruye el « QCameraDevice ».
bool QCameraDevice::isNull() const
Devuelve «true» si este objeto « QCameraDevice » es nulo o no válido.
QList<QSize> QCameraDevice::photoResolutions() const
Devuelve una lista de resoluciones que la cámara puede utilizar para capturar imágenes fijas.
Véase también QImageCapture.
bool QCameraDevice::operator!=(const QCameraDevice &other) const
Devuelve «true» si este objeto ` QCameraDevice ` no representa el mismo dispositivo que ` other`.
QCameraDevice &QCameraDevice::operator=(const QCameraDevice &other)
Establece el objeto ` QCameraDevice ` para que sea igual a ` other`.
bool QCameraDevice::operator==(const QCameraDevice &other) const
Devuelve «true» si este objeto ` QCameraDevice ` representa el mismo dispositivo que ` other`.
Debido al comportamiento de las propiedades de QCameraDevice, dos instancias de QCameraDevice pueden considerarse iguales aunque no todas las propiedades sean iguales.
© 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.