Класс QSensor

Класс QSensor представляет собой отдельный датчик аппаратного обеспечения. Подробнее...

• Список всех членов, включая унаследованные

Типы

Свойства

• 1 свойство унаследовано от QObject

Открытые функции

• 34 public functions inherited from QObject

Public Slots

• 1 public slot inherited from QObject

Signals

• 2 signals inherited from QObject

Статические Public Members

• 10 static public members inherited from QObject

Связанные Non-Members

Дополнительные унаследованные члены

• 1 публичная переменная, унаследованная от QObject
• 9 защищённых функций, унаследованных от QObject
• 2 защищённых переменных, унаследованных от QObject

Подробное описание

Класс QSensor представляет собой отдельный датчик аппаратного обеспечения.

Жизненный цикл датчика обычно следующий:

• Создайте подкласс QSensor в стеке или куче.
• Настройте как требуется приложением.
• Начните получать значения.
• Данные датчика используются приложением.
• Прекратите получать значения.

Данные датчика доставляются через QSensorReading и его подклассы.

Ориентация

Некоторые датчики реагируют на изменения ориентации экрана, такие как QAccelerometer, QMagnetometer и QRotationSensor. Эти датчики называются ориентируемыми датчиками. Для ориентируемых датчиков QSensor поддерживает изменение отчётов о значениях считывания в зависимости от ориентации экрана.

Для ориентируемых датчиков свойство axesOrientationMode контролирует, как ориентация влияет на значения считывания.

В режиме по умолчанию, QSensor::FixedOrientation, значения считывания остаются неизменными при изменении ориентации. В режиме QSensor::AutomaticOrientation значения считывания автоматически поворачиваются с учётом текущей ориентации экрана. И, наконец, в режиме QSensor::UserOrientation значения считывания поворачиваются в соответствии с заданной пользователем ориентацией.

Функциональность доступна только в том случае, если она поддерживается бэкендом и если датчик ориентируемый, что можно проверить, вызвав QSensor::isFeatureSupported() со флагом QSensor::AxesOrientation.

Значения ориентации всегда относятся к ориентации экрана, а не ориентации устройства. Ориентация экрана — это ориентация графического интерфейса пользователя. Например, при повороте устройства на 90 градусов против часовой стрелки ориентация экрана компенсирует это, поворачивая на 90 градусов по часовой стрелке, в результате чего графический интерфейс пользователя по-прежнему будет ориентирован вертикально после поворота устройства. Обратите внимание, что приложения могут блокировать ориентацию экрана, например, для принудительного режима портрета или ландшафта. При заблокированных ориентациях ориентируемые датчики не будут реагировать на изменения значений считывания при изменении ориентации устройства, так как ориентируемые датчики реагируют только на изменения ориентации экрана. Это имеет смысл, поскольку цель ориентируемых датчиков — поддерживать ориентацию датчика синхронизированной с ориентацией экрана.

Значения ориентации изменяются от 0 до 270 градусов. Ориентация применяется по часовой стрелке, например, значение ориентации 90 градусов означает, что экран был повернут на 90 градусов вправо от своего исходного положения, чтобы компенсировать поворот устройства на 90 градусов влево.

См. также QSensorReading.

Документация по типам членов

перечисление QSensor::AxesOrientationMode

Описывает, как значения считывания влияют на ориентацию экрана.

Это перечисление было введено или изменено в Qt 5.1.

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

перечисление QSensor::Feature

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

Общие для всех типов датчиков возможности:

Возможности QMagnetometer:

Возможности QLightSensor:

Возможности QAccelerometer:

Возможности QPressureSensor:

Возможности всех ориентируемых датчиков:

Это перечисление было введено или изменено в Qt 5.0.

См. также QSensor::isFeatureSupported().

Документация по членам-функциям

QSensor::QSensor(const QByteArray &type, QObject *parent = Q_NULLPTR)

Создаёт датчик type как дочерний элемент parent.

Не используйте этот конструктор, если для конкретного типа датчика существует производный класс.

Неправильный способ:

  QSensor *magnetometer = new QSensor(QMagnetometer::type, this);

Правильный способ:

  QMagnetometer *magnetometer = new QMagnetometer(this);

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

Используйте этот конструктор только в том случае, если производный класс датчика недоступен. Обратите внимание, что все встроенные датчики имеют производный класс, поэтому использование этого конструктора необходимо только при реализации пользовательских датчиков, как в примере датчика Grue: Grue sensor example.

[virtual] QSensor::~QSensor()

Уничтожает датчик. Останавливает датчик, если он ещё не остановлен.

[signal] void QSensor::activeChanged()

Этот сигнал излучается, когда свойство QSensor::active изменяется.

Примечание: Сигнал уведомления для свойства active.

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

void QSensor::addFilter(QSensorFilter *filter)

Добавляет filter к датчику.

Датчик не принимает владение фильтром. QSensorFilter сообщит датчику, если он будет уничтожен.

См. также QSensorFilter.

[signal] void QSensor::alwaysOnChanged()

Этот сигнал излучается, когда изменяется свойство alwaysOn.

Примечание: Сигнал уведомления для свойства alwaysOn.

[signal] void QSensor::availableSensorsChanged()

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

См. также QSensor::sensorTypes() и QSensor::sensorsForType().

[signal] void QSensor::busyChanged()

Этот сигнал излучается, когда датчик больше не занят. Это может быть использовано для получения датчика, когда он становится доступным.

  sensor.start();
  if (sensor.isBusy()) {
      // need to wait for busyChanged signal and try again
  }

bool QSensor::connectToBackend()

Попытаться подключиться к бэкенду датчика.

Возвращает true, если подходящий бэкенд был найден, false в противном случае.

Тип должен быть задан до вызова этого метода, если вы используете QSensor напрямую.

Примечание: Эта функция может быть вызвана через систему метаобъектов и из QML. См. Q_INVOKABLE.

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

[static] QByteArray QSensor::defaultSensorForType(const QByteArray &type)

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

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

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

QList<QSensorFilter *> QSensor::filters() const

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

См. также QSensorFilter.

bool QSensor::isFeatureSupported(QSensor::Feature feature) const

Проверяет, поддерживается ли определённая функция бэкендом.

QtSensors поддерживает богатый API для управления и предоставления информации о датчиках. Естественно, не вся эта функциональность поддерживается всеми бэкендами.

Чтобы проверить, поддерживает ли текущий бэкенд функцию feature, вызовите эту функцию.

Бэкенд должен быть подключён, иначе будет возвращено false. Вызов connectToBackend() или start() создаст подключение к бэкенду.

Бэкенды должны реализовать QSensorBackend::isFeatureSupported(), чтобы это работало.

Возвращает, поддерживается ли функция, если бэкенд подключен, или false, если бэкенд не подключен.

Эта функция была введена в Qt 5.0.

Примечание: Эта функция может быть вызвана через систему метаобъектов и из QML. См. Q_INVOKABLE.

[signal] void QSensor::readingChanged()

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

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

Перед тем, как этот сигнал будет излучен впервые, объект чтения будет содержать неинициализированные данные.

Примечание: Сигнал уведомления для свойства reading.

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

void QSensor::removeFilter(QSensorFilter *filter)

Удаляет filter из датчика.

См. также QSensorFilter.

[signal] void QSensor::sensorError(int error)

Этот сигнал излучается, когда на датчике установлено значение error. Обратите внимание, что некоторые ошибки приведут к остановке работы датчика. Вы должны вызвать isActive(), чтобы определить, работает ли датчик.

Примечание: Сигнал уведомления для свойства error.

[static] QList<QByteArray> QSensor::sensorTypes()

Возвращает список всех типов датчиков.

[static] QList<QByteArray> QSensor::sensorsForType(const QByteArray &type)

Возвращает список идентификаторов для каждого датчика типа type. Если датчиков этого типа нет, список будет пустым.

void QSensor::setCurrentOrientation(int currentOrientation)

Устанавливает текущую ориентацию экрана в currentOrientation. Вызывать из бэкенда при изменении ориентации экрана или свойства userOrientation.

Эта функция была добавлена в Qt 5.1.

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

void QSensor::setEfficientBufferSize(int efficientBufferSize)

Устанавливает эффективный размер буфера в efficientBufferSize. Вызывать из бэкенда.

Эта функция была добавлена в Qt 5.1.

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

void QSensor::setMaxBufferSize(int maxBufferSize)

Устанавливает максимальный размер буфера в maxBufferSize. Вызывать из бэкенда.

Эта функция была добавлена в Qt 5.1.

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

void QSensor::setSkipDuplicates(bool skipDuplicates)

Устанавливает пропуск дубликатов в skipDuplicates.

Эта функция была добавлена в Qt 5.1.

Примечание: Функция-сеттер для свойства skipDuplicates.

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

[signal] void QSensor::skipDuplicatesChanged(bool skipDuplicates)

Этот сигнал излучается при изменении свойства skipDuplicates.

Эта функция была добавлена в Qt 5.1.

Примечание: Сигнал-уведомитель для свойства skipDuplicates.

[slot] bool QSensor::start()

Начинает получение значений от датчика. Возвращает true, если датчик запущен, и false в противном случае.

Датчик может не запуститься по нескольким причинам.

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

Например, этот код не будет работать должным образом.

  sensor->start();
  sensor->reading()->x(); // no data available

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

      connect(sensor, SIGNAL(readingChanged()), this, SLOT(checkReading()));
      sensor->start();
  }
  void MyClass::checkReading() {
      sensor->reading()->x();

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

[slot] void QSensor::stop()

Останавливает получение значений от датчика.

Это освобождает датчик, чтобы другие процессы могли его использовать.

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

  typedef QList<qoutputrange> qoutputrangelist;

  typedef QPair<int,int> qrange;

  typedef QList<qrange> qrangelist;