Класс QSensor

Документация по свойствам

active : bool

Это свойство хранит значение, указывающее, активен ли датчик.

Значение true означает, что датчик активен (возвращает значения). В противном случае — false.

Обратите внимание, что установка этого значения в true не окажет немедленного эффекта. Датчик будет запущен после достижения цикла событий.

Функции доступа:

bool	isActive() const
void	setActive(bool active)

Сигнал уведомления:

void	activeChanged()

alwaysOn : bool

Это свойство хранит значение, указывающее, должен ли датчик продолжать работу, когда экран выключен.

На некоторых платформах применяется политика приостановки работы датчиков при выключении экрана. Установка этого свойства в true гарантирует, что датчик будет продолжать работу.

Функции доступа:

bool	isAlwaysOn() const
void	setAlwaysOn(bool alwaysOn)

Сигнал уведомления:

void	alwaysOnChanged()

availableDataRates : const qrangelist

Это свойство хранит скорости передачи данных, которые поддерживает датчик.

Это список скоростей передачи данных, поддерживаемых датчиком. Измеряется в герцах.

Элементы списка могут представлять дискретные скорости или непрерывный диапазон скоростей. Дискретная скорость обозначается одинаковыми значениями.

См. пример sensor_explorer для примера того, как интерпретировать и использовать эту информацию.

Обратите внимание, что эта информация не является обязательной, так как не все датчики имеют скорость, с которой они работают. В таких случаях список будет пустым.

Функции доступа:

qrangelist

availableDataRates() const

См. также 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 градусов.

Это свойство используется только для ориентируемых датчиков.

Это свойство было введено в Qt 5.1.

Функции доступа:

QSensor::AxesOrientationMode	axesOrientationMode() const
void	setAxesOrientationMode(QSensor::AxesOrientationMode axesOrientationMode)

Сигнал уведомления:

void	axesOrientationModeChanged(QSensor::AxesOrientationMode axesOrientationMode)

bufferSize : int

Это свойство хранит размер буфера. По умолчанию размер буфера равен 1, что означает отсутствие буферизации. Если максимальный размер буфера равен 1, то буферизация не поддерживается датчиком.

Установка bufferSize больше, чем maxBufferSize, приведет к использованию maxBufferSize.

Буферизация включается, когда bufferSize больше 1. Датчик соберет запрошенное количество выборок и передаст их все приложению одновременно. Они будут доставлены в приложение как пакет измененных показаний, поэтому особенно важно, чтобы приложение немедленно обрабатывало каждое показание или сохраняло значения где-нибудь еще.

Если вызывается stop() во время буферизации, частичный буфер не доставляется.

Когда датчик запускается с опцией буферизации, значения собираются с этого момента. Нет предварительно существующего буфера, который можно было бы использовать.

Некоторые бэкэнды поддерживают только включение или отключение буфера и не предоставляют управления размером. В этом случае свойства maxBufferSize и efficientBufferSize могут вообще не устанавливаться, даже если буферизация поддерживается. Установка свойства bufferSize в любое значение больше 1 включит буферизацию. После запуска датчика свойство bufferSize будет установлено в фактическое значение бэкэндом.

Функции доступа:

int	bufferSize() const
void	setBufferSize(int bufferSize)

Сигнал уведомления:

void	bufferSizeChanged(int bufferSize)

См. также QSensor::maxBufferSize и QSensor::efficientBufferSize.

busy : const bool

Это свойство хранит значение, указывающее, занят ли датчик.

Некоторые датчики могут быть в системе, но недоступны для использования. Эта функция вернет true, если датчик занят. Вы не сможете start() датчик.

Обратите внимание, что эта функция не возвращает true, если вы используете датчик, а только если датчик используется другим процессом.

Функции доступа:

bool	isBusy() const

См. также busyChanged().

connectedToBackend : const bool

Это свойство хранит значение, указывающее, подключен ли датчик к бэкэнду.

Датчик, который не был подключен к бэкэнду, не может выполнять полезные действия.

Вызовите метод connectToBackend() для принудительного подключения датчика к бэкэнду немедленно. Это вызывается автоматически, если вы вызываете start(), поэтому вам нужно делать это только в том случае, если вам нужен доступ к свойствам датчика (например, для опроса метаданных датчика перед его использованием).

Функции доступа:

bool	isConnectedToBackend() const

currentOrientation : const int

Это свойство хранит текущую ориентацию, которая используется для вращения значений считывания.

Это может не совпадать с ориентацией экрана. Например, в режиме FixedOrientation значения считывания не вращаются, и поэтому свойство равно 0.

В режиме UserOrientation показания вращаются на основе свойства userOrientation, и поэтому это свойство равно свойству userOrientation.

В режиме AutomaticOrientation, показания вращаются в зависимости от ориентации экрана, поэтому данное свойство будет равно текущей ориентации экрана.

Это свойство устанавливается бэкэндом и является допустимым только для сенсоров, которые могут изменять ориентацию.

Это свойство было добавлено в Qt 5.1.

Функции доступа:

int	currentOrientation() const

Сигнал уведомления:

void	currentOrientationChanged(int currentOrientation)

dataRate : int

Это свойство содержит частоту данных, с которой должен работать сенсор.

Измеряется в Герцах.

Частота данных — это максимальная частота, с которой сенсор может обнаруживать изменения.

Установка этого свойства не является переносимой и может вызвать конфликты с другими приложениями. Проверьте документацию бэкэнда сенсора и платформы на предмет политики, касающейся множественных приложений, запрашивающих частоту данных.

Значение по умолчанию (0) означает, что приложение не заботится о частоте данных. Приложения должны рассмотреть использование таймера для опроса текущего значения или убедиться, что код, обрабатывающий значения, может работать очень быстро, так как платформа может предоставлять обновления сотни раз в секунду.

Это свойство должно быть установлено перед вызовом start(), так как сенсор может не заметить изменений в этом значении во время работы.

Обратите внимание, что нет механизма для определения текущей частоты данных, используемой платформой.

Функции доступа:

int	dataRate() const
void	setDataRate(int rate)

Сигнал уведомления:

void	dataRateChanged()

См. также QSensor::availableDataRates.

description : const QString

Это свойство содержит строку описания для сенсора.

Функции доступа:

QString

description() const

efficientBufferSize : const int

Свойство содержит наиболее эффективный размер буфера. Обычно это 1 (что означает, что нет наиболее эффективного размера). Некоторые драйверы сенсоров имеют буфер FIFO, который делает более эффективной доставку значений из FIFO за один раз.

Функции доступа:

int	efficientBufferSize() const

Сигнал уведомления:

void	efficientBufferSizeChanged(int efficientBufferSize)

См. также QSensor::bufferSize и QSensor::maxBufferSize.

error : const int

Это свойство содержит последний код ошибки, установленный для сенсора.

Обратите внимание, что коды ошибок специфичны для сенсора.

Функции доступа:

int	error() const

Сигнал уведомления:

void	sensorError(int error)

identifier : QByteArray

Это свойство содержит идентификатор бэкэнда для сенсора.

Обратите внимание, что идентификатор заполняется автоматически при подключении сенсора к бэкэнду. Если вы хотите подключить определенный бэкэнд, вы должны вызвать setIdentifier() перед connectToBackend().

Функции доступа:

QByteArray	identifier() const
void	setIdentifier(const QByteArray &identifier)

maxBufferSize : const int

Свойство содержит максимальный размер буфера.

Обратите внимание, что это может быть 1, в этом случае сенсор не поддерживает никакую форму буферизации. В этом случае isFeatureSupported(QSensor::Buffering) также вернёт false.

Функции доступа:

int	maxBufferSize() const

Сигнал уведомления:

void	maxBufferSizeChanged(int maxBufferSize)

См. также QSensor::bufferSize и QSensor::efficientBufferSize.

outputRange : int

Это свойство содержит используемый сенсором диапазон вывода.

Это значение представляет собой индекс в списке QSensor::outputRanges, который следует использовать.

Установка этого свойства не является переносимой и может вызвать конфликты с другими приложениями. Проверьте документацию бэкэнда сенсора и платформы на предмет политики, касающейся множественных приложений, запрашивающих диапазон вывода.

Значение по умолчанию (-1) означает, что приложение не заботится о диапазоне вывода.

Обратите внимание, что нет механизма для определения текущего диапазона вывода, используемого платформой.

Функции доступа:

int	outputRange() const
void	setOutputRange(int index)

См. также QSensor::outputRanges.

outputRanges : const qoutputrangelist

Это свойство содержит список диапазонов вывода, поддерживаемых сенсором.

Сенсор может иметь более одного диапазона вывода. Обычно это делается для обеспечения большего диапазона измерений за счет снижения точности.

Обратите внимание, что эта информация не является обязательной. Эта информация обычно доступна только для сенсоров, которые имеют выбираемые диапазоны вывода (таких как типичные акселерометры).

Функции доступа:

qoutputrangelist

outputRanges() const

См. также QSensor::outputRange и qoutputrangelist.

reading : QSensorReading* const

Это свойство содержит класс показаний.

Класс показаний предоставляет доступ к показаниям сенсора. Объект показаний — это переменная кэшированная копия последних полученных показаний сенсора, поэтому приложение должно обрабатывать показания немедленно или сохранять значения где-нибудь для последующей обработки.

Обратите внимание, что это вернёт 0 до тех пор, пока бэкэнд сенсора не будет подключен.

Также обратите внимание, что показания не становятся доступными сразу после вызова start(). Приложения должны дождаться, пока не будет выпущен сигнал readingChanged().

Функции доступа:

QSensorReading *

reading() const

Сигнал уведомления:

void	readingChanged()

См. также isConnectedToBackend() и start().

skipDuplicates : bool

Указывает, следует ли пропускать дублирующиеся значения показаний.

Когда включено пропускание дубликатов, последовательные показания с одинаковыми или очень похожими значениями пропускаются. Это помогает уменьшить объём обработки, так как доступно меньше показаний сенсора. Вследствие этого, показания приходят с нерегулярным интервалом.

Пропускание дубликатов включает не только точные совпадения, но и значения, которые очень похожи, так как каждый сенсор имеет некоторую степень джиттера, даже если устройство не перемещается.

Поддержка этого свойства зависит от бэкэнда. Используйте isFeatureSupported(), чтобы проверить, поддерживается ли она на текущей платформе.

Пропускание дубликатов отключено по умолчанию.

Пропускание дубликатов вступает в силу при запуске сенсора, изменение свойства во время работы сенсора не оказывает немедленного влияния.

Это свойство было добавлено в Qt 5.1.

Функции доступа:

bool	skipDuplicates() const
void	setSkipDuplicates(bool skipDuplicates)

Сигнал уведомления:

void	skipDuplicatesChanged(bool skipDuplicates)

type : const QByteArray

Это свойство содержит тип датчика.

Функции доступа:

QByteArray

type() const

userOrientation : int

Это свойство содержит угол, используемый для поворота значений считывания в режиме UserOrientation.

Когда свойство axesOrientationMode установлено в UserOrientation, угол для поворота значений считывания берется из этого свойства. В других режимах свойство не оказывает влияния.

Значение по умолчанию равно 0. Единственно допустимые значения — 0, 90, 180 и 270, так как это единственные возможные ориентации экрана.

Это свойство является допустимым только для ориентируемых датчиков.

Это свойство было добавлено в Qt 5.1.

Функции доступа:

int	userOrientation() const
void	setUserOrientation(int userOrientation)

Сигнал уведомления:

void	userOrientationChanged(int userOrientation)

  QSensor *magnetometer = new QSensor(QMagnetometer::type, 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;