En esta página

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.

ConstanteValorDescripción
QCameraDevice::UnspecifiedPosition0La posición de la cámara no está especificada o se desconoce.
QCameraDevice::BackFace1La 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::FrontFace2La 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.

Ejemplo con 90 grados \a ángulo de corrección

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.