Класс 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()

[read-only] availableDataRates : const qrangelist

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

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

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

См. пример sensor_explorer для примера интерпретации и использования этой информации.

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

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

qrangelist

availableDataRates() const

См. такжеQSensor::dataRate и qrangelist.

[since 5.1] 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.

[read-only] busy : const bool

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

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

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

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

bool	isBusy() const

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

void	busyChanged()

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

[read-only] connectedToBackend : const bool

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

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

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

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

bool	isConnectedToBackend() const

[read-only, since 5.1] 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.

[read-only] description : const QString

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

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

QString

description() const

[read-only] efficientBufferSize : const int

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

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

int	efficientBufferSize() const

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

void	efficientBufferSizeChanged(int efficientBufferSize)

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

[read-only] error : const int

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

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

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

int	error() const

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

void	sensorError(int error)

identifier : QByteArray

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

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

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

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

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

void	identifierChanged()

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

[read-only] outputRanges : const qoutputrangelist

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

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

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

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

qoutputrangelist

outputRanges() const

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

[read-only] reading : QSensorReading* const

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

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

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

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

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

QSensorReading *

reading() const

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

void	readingChanged()

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

[since 5.1] skipDuplicates : bool

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

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

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

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

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

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

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

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

bool	skipDuplicates() const
void	setSkipDuplicates(bool skipDuplicates)

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

void	skipDuplicatesChanged(bool skipDuplicates)

[read-only] type : const QByteArray

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

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

QByteArray

type() const

[since 5.1] 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::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;