QAccelerometer 类

QAccelerometer 类是方便包裹器围绕 QSensor . 更多...

头: #include <QAccelerometer>
CMake: find_package(Qt6 COMPONENTS Sensors REQUIRED)
target_link_libraries(mytarget PRIVATE Qt6::Sensors)
qmake: QT += sensors
Since: Qt 5.1
继承: QSensor

公共类型

enum AccelerationMode { Combined, Gravity, User }

特性

公共函数

  QAccelerometer (QObject * parent = nullptr)
virtual ~QAccelerometer ()
QAccelerometer::AccelerationMode accelerationMode () const
QAccelerometerReading * reading () const
void setAccelerationMode (QAccelerometer::AccelerationMode accelerationMode )

信号

void accelerationModeChanged (QAccelerometer::AccelerationMode accelerationMode )

详细描述

唯一行为差异是此类正确设置类型。

It also supports changing the acceleration mode, which controls whether the force of gravity is included in the accelerometer values or not.

Furthermore, this class features a reading () 函数返回 QAccelerometerReading 而不是 QSensorReading .

有关传感器如何工作的细节,见 QAccelerometerReading .

另请参阅 QAccelerometerReading .

成员类型文档编制

[since 5.1] enum QAccelerometer:: AccelerationMode

This enum represents the acceleration mode of an acceleration sensor.

The acceleration mode controls how the sensor reports acceleration. QAccelerometer::Combined is the only mode in which the values can be directly physically measured, the others are an approximation.

常量 描述
QAccelerometer::Combined 0 Both the acceleration caused by gravity and the acceleration caused by the user moving the device is reported combined.
QAccelerometer::Gravity 1 Only the acceleration caused by gravity is reported. Movements of the device caused by the user have no effect other than changing the direction when the device is rotated.
QAccelerometer::User 2 Only the acceleration caused by the user moving the device is reported, the effect of gravity is canceled out. A device at rest therefore should report values of, or close to, zero. In other APIs, this mode might be known as linear acceleration .

该枚举在 Qt 5.1 引入或被修改。

另请参阅 QAccelerometer::accelerationMode .

特性文档编制

[since 5.1] accelerationMode : AccelerationMode

This property holds the acceleration mode controls how acceleration values are reported.

The acceleration mode controls how the acceleration sensor reports its values. The default mode is QAccelerometer::Combined , which means the acceleration caused by gravity is included in the reported values.

Acceleration caused by gravity and acceleration caused by the user moving the device are physically impossible to distinguish because of general relativity. Most devices use sensor fusion to figure out which parts of the acceleration is caused by gravity, for example by using a rotation sensor to calculate the gravity direction and assuming a fixed magnitude for gravity. Therefore the result is only an approximation and may be inaccurate. The QAccelerometer::Combined mode is the most accurate one, as it does not involve approximating the gravity.

Not all backends and devices might support setting the acceleration mode. For those cases, the default mode QAccelerometer::Combined is used, changing it has no effect.

该特性在 Qt 5.1 引入。

访问函数:

QAccelerometer::AccelerationMode accelerationMode () const
void setAccelerationMode (QAccelerometer::AccelerationMode accelerationMode )

通知程序信号:

void accelerationModeChanged (QAccelerometer::AccelerationMode accelerationMode )

成员函数文档编制

QAccelerometer:: QAccelerometer ( QObject * parent = nullptr)

构造传感器作为子级对于 parent .

[signal, since 5.1] void QAccelerometer:: accelerationModeChanged ( QAccelerometer::AccelerationMode accelerationMode )

Emitted when the accelerationMode was changed.

注意: 通知程序信号对于特性 accelerationMode .

该函数在 Qt 5.1 引入。

[虚拟] QAccelerometer:: ~QAccelerometer ()

销毁传感器。停止传感器若尚未停止。

QAccelerometerReading *QAccelerometer:: reading () const

返回用于此传感器的读取类。

另请参阅 QSensor::reading ().

[since 5.1] void QAccelerometer:: setAccelerationMode ( QAccelerometer::AccelerationMode accelerationMode )

Sets the acceleration mode to accelerationMode .

注意: setter 函数对于特性 accelerationMode .

该函数在 Qt 5.1 引入。

另请参阅 accelerationMode ().