Back to Qt.io
Contact Us Blog Download Qt

QSensorReading Class

QSensorReading 类保存传感器的读数。更多

头文件： #include <QSensorReading>
CMake： find_package(Qt6 REQUIRED COMPONENTS Sensors)
target_link_libraries(mytarget PRIVATE Qt6::Sensors)
qmake： QT += sensors
继承： QObject
继承于
13 种

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

属性

公共函数

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

宏

DECLARE_READING(classname)
IMPLEMENT_READING(classname)

详细说明

请注意，QSensorReading 本身并不特别有用。每个传感器的相关数据都定义在 QSensorReading 的子类中。

属性文档

[read-only] timestamp : const quint64

该属性保存读数的时间戳。

时间戳的值是从一个固定点开始的微秒数。您可以使用时间戳查看两个传感器读数之间的距离。

请注意，来自不同传感器的传感器时间戳可能无法直接比较（因为它们可能选择不同的固定点作为参考）。

需要注意的是，某些平台无法正确提供时间戳。应用程序应做好准备，以应对偶尔出现的导致时间戳向后跳转的问题。

访问函数：

quint64 timestamp() const

成员函数文档

void QSensorReading::setTimestamp(quint64 timestamp)

设置读数的timestamp 。

另请参阅 timestamp().

quint64 QSensorReading::timestamp() const

返回读取的时间戳。

注： 属性 timestamp 的获取函数。

另请参阅 setTimestamp().

QVariant QSensorReading::value(int index) const

返回index 中的属性值。

请注意，该函数比直接调用数据函数要慢。

下面是一个通过不同机制获取属性的示例。

直接访问可提供最佳性能，但需要编译时了解要访问的数据。

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

您也可以通过名称访问属性。为此，您必须调用QObject::property() 。

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

最后，可以通过数字索引访问值。

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

请注意，value() 只能访问QSensorReading 子类中用Q_PROPERTY() 声明的属性。

另请参见 valueCount() 和QObject::property()。

int QSensorReading::valueCount() const

返回读取的额外属性的数量。

请注意，这不包括QSensorReading 中声明的属性。

例如，QAccelerometerReading 的返回值为 3，因为该类中定义了 3 个属性。

宏文档

DECLARE_READING(classname)

DECLARE_READING 宏为读取类添加了一些必要的方法。

所有阅读类都应使用该宏。传入读取类的classname 。

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);
};

另请参见 IMPLEMENT_READING().

IMPLEMENT_READING(classname)

IMPLEMENT_READING 宏实现了阅读类所需的方法。

所有读取类都应使用该宏。该宏应放在一个编译单元（源文件）中，而不是头文件中。传递读取类的classname 。

IMPLEMENT_READING(MyReading)

另请参见 DECLARE_READING().

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