En esta página

Qt Sensors Descripción general de C++

Tipos de sensores

En un dispositivo puede haber muchos tipos de sensores. Es posible que no estén disponibles todos los tipos que admite la API de Qt Sensors. También puede haber tipos disponibles que no estén definidos en la API de Qt Sensors. Los tipos de sensores disponibles en un dispositivo se pueden consultar mediante la función QSensor::sensorTypes().

Para obtener una lista de los tipos de sensores integrados, consulta la sección «Clases de sensores» más abajo.

Convenciones comunes

A menos que se especifique lo contrario, Qt Sensors utiliza el sistema de coordenadas cartesianas de mano derecha.

Dispositivo con los ejes +x, +y y +z del sistema de coordenadas cartesianas de mano derecha

Para permitir mediciones en las seis direcciones, se utilizan valores negativos.

Dispositivo con ejes x, y y z positivos y negativos que se extienden en las seis direcciones

Cuando se utilice la rotación alrededor de un eje, esta se expresará como una rotación con la mano derecha.

Dispositivo con flechas curvas que indican una rotación en sentido horario alrededor de los ejes x, y y z

En general, los datos del sensor se orientan en relación con QScreen::nativeOrientation, es decir, con respecto a la parte superior del dispositivo cuando este se sostiene en su orientación natural (normalmente, cuando el logotipo del dispositivo aparece en posición correcta). Si los valores se van a mostrar en la pantalla, puede que sea necesario transformarlos para que coincidan con la orientación de la interfaz de usuario. Un sensor puede definir que sus datos estén orientados según la interfaz de usuario. Esto se indicará en la documentación del sensor.

Dispositivo mostrado desde el lateral, la parte delantera, la parte superior y la parte inferior, con los bordes superior e inferior del dispositivo identificados

Uso de un sensor

El ciclo de vida de un QSensor suele ser el siguiente:

  • Crear una instancia de ` QSensor ` o de una de sus subclases en la pila o en el montón.
  • Configurarlo según lo requiera la aplicación.
  • Empezar a recibir valores.
  • La aplicación utiliza los datos del sensor.
  • Deja de recibir valores.

A continuación se muestra un ejemplo de cómo crear un sensor en el montón y en la pila.

// On the heap (deleted when this object is deleted)
QAccelerometer *sensor = new QAccelerometer(this);

// On the stack (deleted when the current scope ends)
QOrientationSensor orient_sensor;

Acceso a los datos del sensor de forma genérica

La forma recomendada de gestionar los datos de los sensores es mediante las clases de lectura. Sin embargo, en ocasiones esto puede no ser posible. Por ejemplo, es posible que estés implementando una aplicación en un dispositivo que cuente con un nuevo tipo de sensor, pero que no disponga de un encabezado C++ que describa la clase de lectura.

Gracias al sistema de propiedades de Qt, aún así puedes acceder a los datos de los sensores. Para ello, necesitas conocer tres datos:

  • El tipo de sensor.
  • El nombre o índice de la propiedad.
  • El tipo de propiedad o un tipo comparable.

Por ejemplo, a continuación se muestra un ejemplo de cómo se puede acceder a una propiedad del acelerómetro. Este código no requiere ningún enlace en tiempo de compilación a QAccelerometer o QAccelerometerReading.

// start the sensor
QSensor sensor("QAccelerometer");
sensor.start();

// later
QSensorReading *reading = sensor.reading();
qreal x = reading->property("x").value<qreal>();
qreal y = reading->value(1).value<qreal>();

También puedes obtener toda esta información en tiempo de ejecución.

Detección de sensores y lectura de propiedades en tiempo de ejecución

A veces puede ocurrir que no se conozcan los sensores disponibles en la fase de desarrollo. Es posible averiguar qué sensores están disponibles tal y como se ilustra a continuación:

QList<QSensor*> mySensorList;
for (const QByteArray&type: QSensor::sensorTypes()) {
    qDebug() << "Found a sensor type:" << type;
   for (const QByteArray&identificador: QSensor::sensorsForType(tipo)) {
        qDebug() << "    " << "Found a sensor of that type:" << identifier;
        QSensor* sensor = new QSensor(type, this);
        sensor->setIdentifier(identifier);
        mySensorList.append(sensor);
    }
}

Además, es posible consultar los detalles de las lecturas de estos sensores, tal y como se muestra a continuación:

for (QSensor* sensor : mySensorList) {
    const int firstProperty = QSensorReading::staticMetaObject.propertyOffset();
    // Conéctate primero al backend por si aún no se ha llamado a start()
    if (!sensor->connectToBackend())
        continue;
    qDebug() << "Sensor" << sensor->identifier() << "reading properties:";
    QSensorReading*reading = sensor->reading();
    if (reading) {
        const QMetaObject*mo = lectura->metaObject();
        for (int i = primeraPropiedad; i < mo->n.ºDePropiedades();++i) {
            QByteArray nombre = mo->property(i).name();
            qDebug() << "    " << name << reading->property(name).toByteArray();
        }
    }
}

Front-end, Back-end

La API de Qt Sensors cuenta con un front-end, destinado a los desarrolladores de aplicaciones, y un back-end, donde los implementadores de dispositivos escriben código para acceder a su hardware. Como desarrollador de aplicaciones, no es necesario que accedas al back-end, aunque puede resultar útil comprender cómo funciona.

Los comandos de la aplicación se envían a través de QSensor y, a continuación, se transmiten al complemento del dispositivo. Los datos se reciben a través de la clase QSensorReading.

Flujo de datos entre la aplicación, QSensor, QSensorBackend, QSensorReading y el complemento del dispositivo

Puedes encontrar más información sobre el back-end en «Qt Sensors Backend».

Clases principales

Las clases principales que conforman la API de Qt Sensors.

QSensor

Representa un único sensor de hardware

QSensorFilter

Función de devolución de llamada eficiente para notificaciones asíncronas de cambios en el sensor

QSensorReading

Almacena las lecturas del sensor

Clases de lectura

La mejor forma de acceder a los datos del sensor es a través de una de estas clases.

QAccelerometerReading

Proporciona información sobre la aceleración lineal a lo largo de los ejes X, Y y Z

QAmbientLightReading

Representa una lectura del sensor de luz ambiental

QAmbientTemperatureReading

Almacena lecturas de la temperatura ambiente

QCompassReading

Representa una lectura del compás

QGyroscopeReading

Representa una lectura del sensor giroscópico

QHumidityReading

Almacena lecturas del sensor de humedad

QLightReading

Representa una lectura del sensor de luz

QMagnetometerReading

Representa una lectura del magnetómetro

QOrientationReading

Representa una lectura del sensor de orientación

QPressureReading

Almacena las lecturas del sensor de presión

QProximityReading

Representa una lectura del sensor de proximidad

QRotationReading

Representa una lectura del sensor de rotación

QTiltReading

Almacena las lecturas del sensor de inclinación

Clases de sensores

Estas clases proporcionan envoltorios prácticos que reducen la necesidad de realizar conversiones de tipos. Cada una de estas clases representa un tipo de sensor reconocido por la API de Qt Sensors. Ten en cuenta que pueden estar disponibles tipos adicionales en tiempo de ejecución. Consulta Tipos de sensores para obtener más información.

QAccelerometer

Envoltura práctica para QSensor

QAmbientLightSensor

Envoltura práctica para QSensor

QAmbientTemperatureSensor

Envoltura de conveniencia para QSensor

QCompass

Envoltura de conveniencia para QSensor

QGyroscope

Envoltura práctica para QSensor

QHumiditySensor

Envoltura práctica para QSensor

QLightSensor

Envoltura práctica para QSensor

QMagnetometer

Envoltura práctica para QSensor

QOrientationSensor

Envoltura práctica para QSensor

QPressureSensor

Envoltura práctica para QSensor

QProximitySensor

Envoltura práctica para QSensor

QRotationSensor

Envoltura práctica para QSensor

QTiltSensor

Envoltura práctica para QSensor

Clases de filtro

Al igual que con las clases de sensores, estas proporcionan envoltorios prácticos que reducen la necesidad de realizar conversiones de tipos.

QAccelerometerFilter

Envoltura práctica en torno a QSensorFilter

QAmbientLightFilter

Envoltura práctica para QSensorFilter

QAmbientTemperatureFilter

Envoltura práctica para QSensorFilter

QCompassFilter

Envoltura práctica para QSensorFilter

QGyroscopeFilter

Envoltura práctica para QSensorFilter

QHumidityFilter

Envoltura práctica para QSensorFilter

QLightFilter

Envoltura práctica para QSensorFilter

QMagnetometerFilter

Envoltura práctica para QSensorFilter

QOrientationFilter

Envoltura práctica para QSensorFilter

QPressureFilter

Envoltura práctica para QSensorFilter

QProximityFilter

Envoltura práctica para QSensorFilter

QRotationFilter

Envoltura práctica para QSensorFilter

QTiltFilter

Envoltura práctica para QSensorFilter

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