Класс QSensor

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

active : bool

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

Истинно, если датчик активен (возвращает значения). Иначе ложно.

Обратите внимание, что установка этого значения в 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;