QSensor Class

属性文档

active : bool

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

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

请注意，将此值设置为 true 不会立即生效。相反，传感器将在事件循环被触发后才开始工作。

访问函数：

通知器信号：

alwaysOn : bool

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

某些平台在屏幕关闭时会自动暂停传感器运行。将此属性设置为 true 可确保传感器继续运行。

访问函数：

通知信号：

[read-only] availableDataRates : 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的任意值将启用缓冲。 传感器启动后，backend 会将 `bufferSize` 属性设置为实际值。

访问函数：

通知信号：

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

[read-only] busy : bool

该属性存储一个值，用于指示传感器是否处于忙碌状态。

某些传感器可能已存在于系统中，但无法使用。如果传感器处于忙碌状态，此函数将返回 true。此时您将无法对该传感器调用 `start()` 函数。

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

访问函数：

通知信号：

另请参阅 busyChanged()。

[read-only] connectedToBackend : bool

该属性存储一个值，用于指示传感器是否已连接到后端。

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

调用connectToBackend()方法可强制传感器立即连接到后端。若调用start()，该方法会自动被调用，因此仅当您需要访问传感器属性时（例如在使用传感器前先轮询其元数据），才需手动执行此操作。

访问函数：

[read-only] currentOrientation : int

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

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

在“UserOrientation ”模式下，读数会根据userOrientation 属性进行旋转，因此该属性等于userOrientation 属性。

在“AutomaticOrientation ”模式下，读数会根据 属性进行旋转，因此该属性将等于 属性。

该属性由后端设置，且仅对可旋转传感器有效。

访问函数：

通知信号：

dataRate : int

该属性存储传感器应运行的数据速率。

单位为赫兹。

数据速率是指传感器能够检测到变化的最大频率。

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

默认值 (0) 表示应用程序不关心数据速率是多少。应用程序应考虑使用基于计时器的轮询来获取当前值，或者确保处理值的代码能够非常快速地运行，因为平台每秒可能会提供数百次更新。

应在调用start()之前设置此属性，因为传感器在运行过程中可能无法察觉此值的变更。

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

访问函数：

通知信号：

另请参阅 QSensor::availableDataRates 。

[read-only] description : QString

该属性存储了传感器的描述性字符串。

访问函数：

[read-only] efficientBufferSize : int

该属性存储最高效的缓冲区大小。通常该值为 1（这意味着没有特定大小是最高效的）。某些传感器驱动程序具有 FIFO 缓冲区，因此一次性传输与 FIFO 大小等量的读数会更高效。

访问函数：

通知信号：

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

[read-only] error : int

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

请注意，错误代码因传感器而异。

访问函数：

通知信号：

identifier : QByteArray

该属性存储了传感器的后端标识符。

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

访问函数：

通知器信号：

[read-only] maxBufferSize : int

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

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

访问函数：

通知信号：

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

outputRange : int

该属性存储传感器当前使用的输出范围。

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

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

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

请注意，目前尚无机制可确定平台当前使用的输出范围。

访问函数：

另请参阅 QSensor::outputRanges 。

[read-only] outputRanges : qoutputrangelist

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

一个传感器可能具有多个输出量程。通常这样做是为了在牺牲精度的前提下获得更大的测量范围。

请注意，此信息并非必填项。通常只有具有可选输出范围的传感器（例如典型的加速度计）才会提供此信息。

访问函数：

另请参阅 QSensor::outputRange 和qoutputrangelist 。

[read-only] reading : QSensorReading*

该属性存储读取类。

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

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

另请注意，在调用start()后，读数并非立即可用。应用程序必须等待readingChanged()信号被触发。

访问函数：

通知器信号：

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

skipDuplicates : bool

用于指定是否应忽略重复的读数值。

启用重复值跳过功能后，连续且数值相同或非常相近的读数将被跳过。这有助于减少处理量，因为可供处理的传感器读数会减少。因此，读数到达的间隔会变得不规律。

重复值跳过功能不仅针对完全相同的读数，也针对非常相似的读数，因为即使设备未移动，每个传感器也会存在一定的抖动。

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

默认情况下，重复数据跳过功能处于禁用状态。

重复跳过功能在传感器启动时生效，在传感器活动期间更改该属性不会立即生效。

访问函数：

通知信号：

[read-only] 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;