QSensor类

属性文档

active : bool

此属性保留一个值，表示该传感器是否处于活动状态。

如果传感器处于活动状态（返回值），则为 true。否则为 false。

请注意，将此值设置为 true 不会产生即时效果。相反，一旦进入事件循环，传感器将被启动。

访问函数

通知信号

alwaysOn : bool

此属性保留一个值，表示传感器在屏幕关闭时是否应该继续运行。

某些平台在屏幕关闭时会有挂起传感器的策略。将此属性设置为 true 将确保传感器继续运行。

访问函数

通知信号

[只读] availableDataRates : const qrangelist

此属性保留传感器支持的数据率。

这是一个支持的数据率列表。以赫兹为单位。

列表中的条目可以表示离散率或一系列的率。具有相同值的条目表示离散率。

请注意，此信息不是强制性的，因为并非所有传感器都有运行速率。在这种情况下，列表将为空。

访问函数

另请参阅 QSensor::dataRate 和 qrangelist。

axesOrientationMode : AxesOrientationMode

该属性存储着影响屏幕方向变化读取值的模式。

当设置为FixedOrientation（默认模式）时，读取值不会应用自动旋转。这是不支持QSensor::AxesOrientation功能的后端可用的唯一模式。

当设置为AutomaticOrientation时，在屏幕方向变化时，读取值将自动旋转。实际上，屏幕方向被取消。

举例来说，假设设备旋转了180度，因此屏幕方向也从原生方向旋转了180度。没有自动轴方向，读取值现在会改变：X和Y值都会取反，迫使应用程序开发者手动在应用程序代码中取消取反。自动轴方向会自动完成此操作，在这种模式下，X和Y值将与默认屏幕方向相同。

这种自动旋转轴对于某些用例很有用，例如在测量水平度的气泡水平仪应用程序中，通过检查加速度计的X轴值来测量表面水平。当地设备和屏幕方向旋转90度时，应用程序开发者不需要做任何改变，即使在设备旋转后，他也可以继续使用X轴值。如果没有自动轴方向，应用程序开发者需要查看Y值，从而根据屏幕方向在不同的轴上增加读取应用程序的代码。

UserOrientation模式与AutomaticOrientation模式非常相似，只是屏幕方向是手动控制而不是自动确定。然后使用userOrientation属性的角来旋转读取值。

由于读取值的旋转基于屏幕方向，Z值永远不会改变，因为Z轴是垂直于屏幕的。屏幕方向以90度步进变化时，读取值的旋转也是以90度步进进行。

此属性仅用于可导向传感器。

访问函数

通知信号

bufferSize : int

该属性存储着缓冲区的大小。默认情况下，缓冲区大小为1，这意味着没有缓冲。如果最大缓冲区大小为1，则传感器不支持缓冲。

设置 bufferSize 大于 maxBufferSize 将会导致使用 maxBufferSize。

当 bufferSize 大于1时，会打开缓冲。传感器将收集请求的样本数，并一次性将它们全部提供给应用程序。它们将以读数改变的突发方式提供给应用程序，因此特别重要的是，应用程序必须立即处理每个读取值或将其保存在其他地方。

如果缓冲正在进行时调用 stop()，则不会交付部分的缓冲。

当缓冲选项启动传感器时，将从那时起收集值。没有现有的缓冲区可以利用。

某些后端仅支持启用或禁用缓冲，并不提供对大小的控制。在这种情况下，即使支持缓冲，maxBufferSize和efficientBufferSize属性可能根本未设置。将bufferSize属性设置为大于1的任何值将启用缓冲。一旦传感器启动，bufferSize属性将由后端设置为实际值。

访问函数

通知信号

另请参阅QSensor::maxBufferSize 和 QSensor::efficientBufferSize.

[只读] busy : const bool

此属性包含一个用于表示传感器是否忙碌的值。

某些传感器可能存在于系统中，但不可使用。如果传感器正忙，此函数将返回 true。您将无法启动传感器。

请注意，如果您正在使用传感器，则此函数不返回 true，只有当另一个进程正在使用该传感器时才会返回 true。

访问函数

通知信号

另请参阅busyChanged。

[只读] connectedToBackend : const bool

此属性包含一个用于表示传感器是否已连接到后端的值。

尚未连接到后端的传感器无法完成任何有用的操作。

调用 connectToBackend() 方法可以强制传感器立即连接到后端。如果您调用start，这会自动完成，因此您只需要这样做，如果您需要访问传感器属性（例如，在使用传感器之前轮询传感器的元数据）。

访问函数

[只读] currentOrientation : const int

此属性包含用于旋转读数值的当前方向。

它可能不与屏幕方向相同。例如，在FixedOrientation模式中，读数值不会旋转，因此属性为0。

在UserOrientation模式中，读数值根据userOrientation属性的值进行旋转，因此该属性值等于userOrientation属性。

在AutomaticOrientation模式中，读数值根据屏幕方向进行旋转，因此此属性值等于当前屏幕方向。

此属性由后端设置，并且仅对可导向传感器有效。

访问函数

通知信号

dataRate : int

此属性包含传感器应运行的数据速率。

以赫兹为单位测量。

数据速率是传感器可以检测变化的最高频率。

设置此属性是不可移植的，并可能导致与其他应用程序发生冲突。检查传感器后端和平台文档以获取有关多个应用程序请求数据速率的任何策略。

默认值（0）表示应用程序不关心数据速率。应用程序应考虑使用基于计时器的轮询当前值，或确保处理值的代码可以非常快地运行，因为平台每秒可能提供 hundreds 次更新。

应在调用start之前设置此属性，因为当传感器运行时，它可能不会注意到此值的更改。

请注意，该平台没有确定当前使用的数据速率的机制。

访问函数

通知信号

参见 QSensor::availableDataRates.

[只读] description : const QString

此属性包含传感器的描述性字符串。

访问函数

[只读] efficientBufferSize : const int

此属性包含最有效的缓冲区大小。通常这是1（表示没有特定大小是最有效的）。一些传感器驱动程序具有FIFO缓冲区，这使得一次性发送FIFO大小的读取内容更为有效。

访问函数

通知信号

参见 QSensor::bufferSize 和 QSensor::maxBufferSize.

[只读] error : const int

此属性包含设置在传感器上的最后一个错误代码。

请注意，错误代码是传感器特定的。

访问函数

通知信号

identifier : QByteArray

此属性包含传感器的后端标识符。

请注意，标识符在传感器连接到后端时会自动填写。如果您想连接特定的后端，应在 connectToBackend() 之前调用 setIdentifier()。

访问函数

通知信号

[只读] maxBufferSize : const int

此属性包含最大缓冲区大小。

请注意，这可能是1，在这种情况下，传感器不支持任何形式的缓冲。在这种情况下，isFeatureSupported(QSensor::Buffering) 也会返回false。

访问函数

通知信号

参见 QSensor::bufferSize 和 QSensor::efficientBufferSize.

outputRange : int

此属性包含传感器当前使用的输出范围。

此值表示在 QSensor::outputRanges 列表中使用的索引。

设置此属性不可移植，可能会导致与其他应用程序发生冲突。请查阅传感器后端和平台文档，以获取有关多个应用程序请求输出范围的政策。

默认值（-1）表示应用不需要关心输出范围。

请注意，没有机制来确定平台当前使用的输出范围。

访问函数

参见 QSensor::outputRanges.

[只读] outputRanges : const qoutputrangelist

此属性包含传感器支持的输出范围列表。

传感器可能具有多个输出范围。通常，这样做是为了扩大测量范围，但会降低精度。

请注意，此信息不是强制的。此信息通常仅适用于具有可选用输出范围的传感器（例如典型的加速度计）。

访问函数

另请参阅QSensor::outputRange 和 qoutputrangelist。

[只读] reading : QSensorReading* const

此属性包含读取类。

读取类提供对传感器读取数据的访问。读取对象是最新的传感器读取数据的易失性缓存，因此应用程序应立即处理读取数据或将其保存到其他地方以供稍后处理。

请注意，在将传感器后端连接到后端之前，此函数将返回0。

请注意，在调用start()之后，读取数据并不立即可用。应用程序必须等待readingChanged()信号被发出。

访问函数

通知信号

另请参阅isConnectedToBackend() 和 start。

skipDuplicates : bool

指示是否应省略重复的读取值。

启用重复跳过时，省略具有相同或非常相似值的连续读取。这有助于减少处理量，因为可用的传感器读取较少。因此，读取数据以不规则的时间间隔到达。

重复跳过不仅适用于完全相同的读取，而且还适用于相当相似的读取，因为即使在设备未被移动的情况下，每个传感器也有一点点抖动。

对此属性的支持取决于后端。使用isFeatureSupported()检查当前平台是否支持。

默认情况下禁用重复跳过。

传感器的重复跳过将生效，当传感器开始时，在传感器活动时更改属性不会立即产生效果。

访问函数

通知信号

[只读] type : const QByteArray

此属性包含传感器的类型。

访问函数

userOrientation : int

此属性包含在UserOrientation模式中用于旋转读取值的角度。

当将axesOrientationMode属性设置为UserOrientation时，旋转读取值的角度取自此属性。在其他模式下，属性没有任何效果。

默认值为0。唯一有效的值是0、90、180和270，因为这些是唯一的可能屏幕方向。

此属性仅对可旋转传感器有效。

访问函数

通知信号

QSensor *magnetometer = new QSensor(QMagnetometer::sensorType, this);

QMagnetometer *magnetometer = new QMagnetometer(this);

sensor.start();
if (sensor.isBusy()) {
    // need to wait for busyChanged signal and try again
}

sensor->start();
sensor->reading()->x(); // no data available

    connect(sensor, SIGNAL(readingChanged()), this, SLOT(checkReading()));
    sensor->start();
}
void MyClass::checkReading() {
    sensor->reading()->x();

typedef QList<qoutputrange> qoutputrangelist;

typedef QPair<int,int> qrange;

typedef QList<qrange> qrangelist;