En esta página

QSensorReading Class

La clase `QSensorReading` contiene las lecturas del sensor. Más información...

Encabezado: #include <QSensorReading>
CMake: find_package(Qt6 REQUIRED COMPONENTS Sensors)
target_link_libraries(mytarget PRIVATE Qt6::Sensors)
qmake: QT += sensors
Heredado de: QObject
Heredado por:
13 tipos

QAccelerometerReading, QAmbientLightReading, QAmbientTemperatureReading, QCompassReading, QGyroscopeReading, QHumidityReading, QLightReading, QMagnetometerReading, QOrientationReading, QPressureReading, QProximityReading, QRotationReading y QTiltReading

Propiedades

Funciones públicas

void setTimestamp(quint64 timestamp)
quint64 timestamp() const
QVariant value(int index) const
int valueCount() const

Macros

DECLARE_READING(classname)
IMPLEMENT_READING(classname)

Descripción detallada

Ten en cuenta que QSensorReading no resulta especialmente útil por sí sola. Los datos de interés para cada sensor se definen en una subclase de QSensorReading.

Documentación de las propiedades

[read-only] timestamp : quint64

Esta propiedad contiene la marca de tiempo de la lectura.

Los valores de las marcas de tiempo se expresan en microsegundos desde un punto fijo. Puedes utilizar las marcas de tiempo para ver la diferencia entre dos lecturas de sensores.

Ten en cuenta que las marcas de tiempo de distintos sensores pueden no ser directamente comparables (ya que pueden elegir diferentes puntos fijos como referencia).

Ten en cuenta que algunas plataformas no proporcionan las marcas de tiempo correctamente. Las aplicaciones deben estar preparadas para problemas ocasionales que provoquen que las marcas de tiempo den un salto hacia atrás.

Funciones de acceso:

quint64 timestamp() const

Documentación de funciones de miembro

void QSensorReading::setTimestamp(quint64 timestamp)

Establece el valor de « timestamp » de la lectura.

Véase también timestamp().

quint64 QSensorReading::timestamp() const

Devuelve la marca de tiempo de la lectura.

Nota: Funcióngetter para la propiedad «timestamp».

Véase también ` setTimestamp()`.

QVariant QSensorReading::value(int index) const

Devuelve el valor de la propiedad en index.

Ten en cuenta que esta función es más lenta que llamar directamente a la función «data».

A continuación se muestra un ejemplo de cómo obtener una propiedad mediante los distintos mecanismos disponibles.

El acceso directo ofrece el mejor rendimiento, pero requiere conocer en tiempo de compilación los datos a los que se accede.

QAccelerometerReading *reading = ...;
qreal x = reading->x();

También puedes acceder a una propiedad por su nombre. Para ello, debes llamar a ` QObject::property()`.

qreal x = reading->property("x").value<qreal>();

Por último, se puede acceder a los valores mediante un índice numérico.

qreal x = reading->value(0).value<qreal>();

Ten en cuenta que `value()` solo puede acceder a propiedades declaradas con ` Q_PROPERTY()` en subclases de ` QSensorReading`.

Véanse también ` valueCount()` y ` QObject::property()`.

int QSensorReading::valueCount() const

Devuelve el número de propiedades adicionales que tiene la lectura.

Ten en cuenta que esto no cuenta las propiedades declaradas en ` QSensorReading`.

Por ejemplo, devuelve 3 para QAccelerometerReading, ya que hay 3 propiedades definidas en esa clase.

Documentación de macros

DECLARE_READING(classname)

La macro DECLARE_READING añade algunos métodos obligatorios a una clase de lectura.

Esta macro debe utilizarse para todas las clases de lectura. Pasa el objeto ` classname ` de tu clase de lectura.

class MyReadingPrivate;

class MyReading : public QSensorReading
{
    Q_OBJECT
    Q_PROPERTY(qreal myprop READ myprop)
    DECLARE_READING(MyReading)
public:
    qreal myprop() const;
    void setMyprop(qreal myprop);
};

Véase también IMPLEMENT_READING().

IMPLEMENT_READING(classname)

La macro IMPLEMENT_READING implementa los métodos necesarios para una clase de lectura.

Esta macro debe utilizarse para todas las clases de lectura. Debe colocarse en una única unidad de compilación (archivo fuente), no en un archivo de cabecera. Pásale la función classname de tu clase de lectura.

IMPLEMENT_READING(MyReading)

Véase también DECLARE_READING().

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