En esta página

QSensorBackend Class

La clase QSensorBackend es una implementación de sensor. Más información...

Encabezado: #include <QSensorBackend>
CMake: find_package(Qt6 REQUIRED COMPONENTS Sensors)
target_link_libraries(mytarget PRIVATE Qt6::Sensors)
qmake: QT += sensors
Heredado de: QObject

Funciones públicas

void addDataRate(qreal min, qreal max)
void addOutputRange(qreal min, qreal max, qreal accuracy)
virtual bool isFeatureSupported(QSensor::Feature feature) const
void newReadingAvailable()
QSensorReading *reading() const
QSensor *sensor() const
void sensorBusy(bool busy = true)
void sensorError(int error)
void sensorStopped()
void setDataRates(const QSensor *otherSensor)
void setDescription(const QString &description)
T *setReading(T *reading)
virtual void start() = 0
virtual void stop() = 0

Descripción detallada

Los sensores de un dispositivo estarán representados por subclases de QSensorBackend.

Documentación de las funciones de miembro

void QSensorBackend::addDataRate(qreal min, qreal max)

Añade una velocidad de transmisión de datos (compuesta por los valores « min » y « max ») para el sensor.

Ten en cuenta que esta función debe invocarse desde el constructor para que la información esté disponible de inmediato.

Véase también QSensor::availableDataRates.

void QSensorBackend::addOutputRange(qreal min, qreal max, qreal accuracy)

Añade un rango de salida (compuesto por los valores min, max y accuracy) para el sensor.

Ten en cuenta que esta función debe llamarse desde el constructor para que la información esté disponible de inmediato.

Véase también QSensor::outputRange y QSensor::outputRanges.

[virtual] bool QSensorBackend::isFeatureSupported(QSensor::Feature feature) const

Comprueba si este backend del sensor es compatible con una determinada función.

Esta es la parte correspondiente al backend de QSensor::isFeatureSupported(). Reimplementa esta función si el backend admite alguna de las funciones adicionales del sensor que se describen en QSensor::Feature.

Devuelve si el backend admite la función feature. La implementación por defecto devuelve «false».

void QSensorBackend::newReadingAvailable()

Notificar a la clase ` QSensor ` que hay una nueva lectura disponible.

QSensorReading *QSensorBackend::reading() const

Si el backend ha perdido la referencia a la lectura, puede llamar a este método para obtener la dirección.

Ten en cuenta que tendrás que realizar un downcast al tipo adecuado.

Véase también setReading().

QSensor *QSensorBackend::sensor() const

Devuelve el front-end del sensor asociado a este back-end.

void QSensorBackend::sensorBusy(bool busy = true)

Notifica al front-end el estado de ocupado del sensor según el parámetro busy proporcionado.

Si el sensor se establece como ocupado, esto llama implícitamente a ` sensorStopped()`. La indicación de ocupación se realiza normalmente en ` start()`.

Ten en cuenta que el front-end debe llamar a QSensor::isBusy() para comprobar si el sensor está ocupado. Si el sensor se ha detenido debido a un error, se debe llamar a la función sensorError() para notificar a la clase la condición de error.

void QSensorBackend::sensorError(int error)

Notifica al front-end que se ha producido un error en el sensor. Ten en cuenta que esto solo notifica un código « error ». No desactiva el sensor.

Véase también sensorStopped().

void QSensorBackend::sensorStopped()

Notifica al front-end que el sensor se ha detenido. Esto puede deberse a que la llamada a ` start()` haya fallado o a alguna causa imprevista (por ejemplo, un fallo de hardware).

Ten en cuenta que el front-end debe llamar a QSensor::isActive() para comprobar si el sensor se ha detenido. Si el sensor se ha detenido debido a un error, se debe llamar a la función sensorError() para notificar a la clase la condición de error.

void QSensorBackend::setDataRates(const QSensor *otherSensor)

Configura las velocidades de transmisión de datos del sensor según lo indicado en otherSensor.

Está pensado para sensores que se basan en otros sensores.

setDataRates(otherSensor);

Ten en cuenta que esta función debe invocarse desde el constructor.

Véase también QSensor::availableDataRates y addDataRate().

void QSensorBackend::setDescription(const QString &description)

Establece el valor de « description » para el sensor.

Ten en cuenta que esta función debe invocarse desde el constructor para que la información esté disponible de inmediato.

template <typename T> T *QSensorBackend::setReading(T *reading)

Esta función se invoca para inicializar las clases « reading » utilizadas para un sensor.

Si tu backend ya ha asignado una lectura, debes pasar la dirección de esta a la función. De lo contrario, debes pasar 0 y la función devolverá la dirección de la lectura que tu backend debe utilizar cuando quiera notificar a la API del sensor nuevas lecturas.

Ten en cuenta que se trata de una función de plantilla, por lo que debe invocarse con el tipo adecuado.

class MyBackend : public QSensorBackend
{
    QAccelerometerReading m_reading;
public:
    MyBackend(QSensor *sensor)
        : QSensorBackend(sensor)
    {
        setReading<QAccelerometerReading>(&m_reading);
    }

    ...

Ten en cuenta que esta función debe invocarse; de lo contrario, no podrás enviar lecturas al front-end.

Si no deseas almacenar la dirección de la lectura, puedes utilizar el método ` reading()` para volver a obtenerla más tarde.

class MyBackend : public QSensorBackend
{
public:
    MyBackend(QSensor *sensor)
        : QSensorBackend(sensor)
    {
        setReading<QAccelerometerReading>(0);
    }

    void poll()
    {
        quint64 timestamp;
        qreal x, y, z;
        ...
        QAccelerometerReading *reading = static_cast<QAccelerometerReading*>(reading());
        reading->setTimestamp(timestamp);
        reading->setX(x);
        reading->setY(y);
        reading->setZ(z);
    }

    ...

Véase también reading().

[pure virtual] void QSensorBackend::start()

Empieza a introducir los valores.

[pure virtual] void QSensorBackend::stop()

Deja de comunicar los valores.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.