QSensor Class

属性文档

active : bool

该属性包含一个值，用于指示传感器是否处于活动状态。

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

请注意，将此值设置为 true 不会立即生效。相反，一旦到达事件循环，传感器就会启动。

访问功能：

通知信号：

alwaysOn : bool

此属性包含一个值，用于指示传感器是否应在屏幕关闭时继续运行。

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

访问功能：

通知信号：

[read-only] 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，则传感器不支持缓冲。

设置缓冲区大小大于maxBufferSize 将导致使用maxBufferSize 。

当缓冲区大小大于 1 时，缓冲将打开。 传感器将收集所请求的样本数量，并一次性将它们全部传送到应用程序。它们将以读数变化脉冲串的形式发送到应用程序，因此应用程序立即处理每个读数或将数值保存到其他地方尤为重要。

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

当使用缓冲选项启动传感器时，将从那时起开始收集数值。没有预先存在的缓冲区可以利用。

有些后端只支持启用或禁用缓冲区，而不提供对缓冲区大小的控制。在这种情况下，即使支持缓冲，也可能根本不设置maxBufferSize 和efficientBufferSize 属性。将缓冲区大小（bufferSize）属性设置为任何大于 1 的值都将启用缓冲。传感器启动后，后端会将缓冲区大小属性设置为实际值。

访问功能：

通知信号：

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

[read-only] busy : const bool

该属性包含一个值，用于指示传感器是否繁忙。

有些传感器可能在系统中，但无法使用。如果传感器忙，此函数将返回 true。您将无法start() 传感器。

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

访问功能：

通知信号：

另请参阅 busyChanged() 。

[read-only] connectedToBackend : const bool

该属性的值表示传感器是否已连接到后端。

未连接到后台的传感器无法执行任何有用的操作。

调用connectToBackend() 方法可强制传感器立即连接到后端。如果调用start() 方法，该方法将被自动调用，因此只有在需要访问传感器属性（即在使用前轮询传感器的元数据）时才需要调用该方法。

访问功能：

[read-only] currentOrientation : const int

该属性保存当前用于旋转读数值的方向。

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

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

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

该属性由后台设置，仅对可定向传感器有效。

访问功能：

通知信号：

dataRate : int

该属性保存传感器运行时的数据传输速率。

单位为赫兹。

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

设置此属性不具有可移植性，可能会与其他应用程序发生冲突。请查阅传感器后端和平台文档，了解有关多个应用程序请求数据速率的政策。

默认值 (0) 表示应用程序不关心数据速率。应用程序应考虑使用定时器轮询当前值，或确保处理值的代码能够快速运行，因为平台可能每秒提供数百次更新。

该值应在调用start() 之前设置，因为传感器在运行时可能不会注意到该值的变化。

请注意，没有任何机制可以确定平台当前使用的数据传输速率。

访问功能：

通知信号：

另请参见 QSensor::availableDataRates 。

[read-only] description : const QString

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

访问功能：

[read-only] efficientBufferSize : const int

该属性表示最有效的缓冲区大小。通常为 1（这意味着没有特定的大小是最有效的）。有些传感器驱动程序有一个先进先出缓冲区，这样就能更有效地一次性提供相当于先进先出缓冲区大小的读数。

访问功能：

通知信号：

另请参见 QSensor::bufferSize 和QSensor::maxBufferSize 。

[read-only] error : const int

此属性保存传感器上设置的最后一个错误代码。

请注意，错误代码与传感器有关。

访问功能：

通知信号：

identifier : QByteArray

此属性保存传感器的后端标识符。

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

访问功能：

通知信号：

[read-only] maxBufferSize : const int

该属性保存最大缓冲区大小。

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

访问功能：

通知信号：

另请参见 QSensor::bufferSize 和QSensor::efficientBufferSize 。

outputRange : int

该属性保存传感器使用的输出范围。

该值表示QSensor::outputRanges 列表中要使用的索引。

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

默认值 (-1) 表示应用程序不关心输出范围。

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

访问功能：

另请参阅 QSensor::outputRanges 。

[read-only] outputRanges : const qoutputrangelist

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

传感器可以有多个输出范围。通常情况下，这样做的目的是以降低精度为代价获得更大的测量范围。

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

访问功能：

另请参阅 QSensor::outputRange 和qoutputrangelist 。

[read-only] reading : QSensorReading* const

该属性包含读数类。

读取类提供对传感器读数的访问。读取对象是已接收到的最新传感器读数的易失性缓存，因此应用程序应立即处理读数，或将数值保存在某处以备日后处理。

请注意，在传感器后端连接到后端之前，该对象将返回 0。

还要注意的是，调用start() 后，读数不会立即可用。应用程序必须等待readingChanged() 信号发出。

访问功能：

Notifier 信号：

另请参阅 isConnectedToBackend() 和start()。

skipDuplicates : bool

表示是否应省略重复读数值。

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

重复跳过不仅适用于完全相同的读数，也适用于非常相似的读数，因为即使设备没有移动，每个传感器也会有一些抖动。

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

重复跳过默认为禁用。

重复跳过在传感器启动时生效，在传感器处于活动状态时更改该属性不会立即生效。

访问功能：

通知信号：

[read-only] type : const QByteArray

该属性表示传感器的类型。

访问功能：

userOrientation : int

该属性用于保存在UserOrientation 模式下旋转读数的角度。

当axesOrientationMode 属性设置为UserOrientation 时，读数值的旋转角度取自该属性。在其他模式下，该属性不起作用。

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

该属性仅对可定向传感器有效。

访问功能：

Notifier 信号：

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;