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

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

AxesOrientationMode	axesOrientationMode() const
void	setAxesOrientationMode(AxesOrientationMode axesOrientationMode)

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

void	axesOrientationModeChanged(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;