En esta página

QSensor Class

La clase QSensor representa un único sensor de hardware. Más información...

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

QAccelerometer, QAmbientLightSensor, QAmbientTemperatureSensor, QCompass, QGyroscope, QHumiditySensor, QLightSensor, QMagnetometer, QOrientationSensor, QPressureSensor, QProximitySensor, QRotationSensor y QTiltSensor

Tipos públicos

enum AxesOrientationMode { FixedOrientation, AutomaticOrientation, UserOrientation }
enum Feature { Buffering, AlwaysOn, SkipDuplicates, GeoValues, FieldOfView, …, AxesOrientation }

Propiedades

Funciones públicas

QSensor(const QByteArray &type, QObject *parent = nullptr)
virtual ~QSensor()
void addFilter(QSensorFilter *filter)
qrangelist availableDataRates() const
QSensor::AxesOrientationMode axesOrientationMode() const
int bufferSize() const
bool connectToBackend()
int currentOrientation() const
int dataRate() const
QString description() const
int efficientBufferSize() const
int error() const
QList<QSensorFilter *> filters() const
QByteArray identifier() const
bool isActive() const
bool isAlwaysOn() const
bool isBusy() const
bool isConnectedToBackend() const
bool isFeatureSupported(QSensor::Feature feature) const
int maxBufferSize() const
int outputRange() const
qoutputrangelist outputRanges() const
QSensorReading *reading() const
void removeFilter(QSensorFilter *filter)
void setActive(bool active)
void setAlwaysOn(bool alwaysOn)
void setAxesOrientationMode(QSensor::AxesOrientationMode axesOrientationMode)
void setBufferSize(int bufferSize)
void setCurrentOrientation(int currentOrientation)
void setDataRate(int rate)
void setEfficientBufferSize(int efficientBufferSize)
void setIdentifier(const QByteArray &identifier)
void setMaxBufferSize(int maxBufferSize)
void setOutputRange(int index)
void setSkipDuplicates(bool skipDuplicates)
void setUserOrientation(int userOrientation)
bool skipDuplicates() const
QByteArray type() const
int userOrientation() const

Ranuras públicas

bool start()
void stop()

Señales

void activeChanged()
void alwaysOnChanged()
void availableSensorsChanged()
void axesOrientationModeChanged(QSensor::AxesOrientationMode axesOrientationMode)
void bufferSizeChanged(int bufferSize)
void busyChanged()
void currentOrientationChanged(int currentOrientation)
void dataRateChanged()
void efficientBufferSizeChanged(int efficientBufferSize)
void identifierChanged()
void maxBufferSizeChanged(int maxBufferSize)
void readingChanged()
void sensorError(int error)
void skipDuplicatesChanged(bool skipDuplicates)
void userOrientationChanged(int userOrientation)

Miembros públicos estáticos

QByteArray defaultSensorForType(const QByteArray &type)
QList<QByteArray> sensorTypes()
QList<QByteArray> sensorsForType(const QByteArray &type)

Descripción detallada

El ciclo de vida de un sensor suele ser el siguiente:

  • Crear una subclase de QSensor en la pila o en el montón.
  • Configurarlo según lo requiera la aplicación.
  • Empezar a recibir valores.
  • La aplicación utiliza los datos del sensor.
  • Dejar de recibir valores.

Los datos del sensor se transmiten a través de ` QSensorReading ` y sus subclases.

Orientación

Algunos sensores reaccionan a los cambios de orientación de la pantalla, como QAccelerometer, QMagnetometer y QRotationSensor. Estos se denominan sensores orientables. En el caso de los sensores orientables, QSensor permite modificar la forma en que se comunican los valores de lectura en función de la orientación de la pantalla.

En el caso de los sensores orientables, la propiedad axesOrientationMode controla cómo afecta la orientación a los valores de lectura.

En el modo predeterminado, ` QSensor::FixedOrientation`, los valores de lectura no se ven afectados por la orientación. En el modo ` QSensor::AutomaticOrientation `, los valores de lectura se giran automáticamente teniendo en cuenta la orientación actual de la pantalla. Y, por último, en el modo ` QSensor::UserOrientation `, los valores de lectura se giran según una orientación especificada por el usuario.

Esta funcionalidad solo está disponible si es compatible con el backend y si el sensor es orientable, lo cual se puede comprobar llamando a QSensor::isFeatureSupported() con el indicador QSensor::AxesOrientation.

Los valores de orientación aquí se refieren siempre a la orientación de la pantalla, no a la del dispositivo. La orientación de la pantalla es la orientación de la interfaz gráfica de usuario (GUI). Por ejemplo, al girar un dispositivo 90 grados en sentido antihorario, la orientación de la pantalla lo compensa girando 90 grados en sentido horario, de modo que la GUI sigue orientada en posición vertical después de que el dispositivo haya sido girado. Ten en cuenta que las aplicaciones pueden bloquear la orientación de la pantalla, por ejemplo, para forzar el modo vertical u horizontal. En el caso de las orientaciones bloqueadas, los sensores orientables no reaccionarán con cambios en la lectura si se modifica la orientación del dispositivo, ya que estos sensores solo reaccionan a los cambios en la orientación de la pantalla. Esto tiene sentido, ya que el propósito de los sensores orientables es mantener la orientación del sensor sincronizada con la orientación de la pantalla.

Los valores de orientación oscilan entre 0 y 270 grados. La orientación se aplica en el sentido de las agujas del reloj; por ejemplo, un valor de orientación de 90 grados significa que la pantalla se ha girado 90 grados hacia la derecha desde su posición original, para compensar una rotación del dispositivo de 90 grados hacia la izquierda.

Véase también QSensorReading.

Documentación sobre tipos de miembros

enum QSensor::AxesOrientationMode

Describe cómo la orientación de la pantalla influye en los valores de lectura.

ConstanteValorDescripción
QSensor::FixedOrientation0No se aplica ninguna rotación automática a los valores de lectura.
QSensor::AutomaticOrientation1Los valores de lectura se giran automáticamente en función de la orientación de la pantalla.
QSensor::UserOrientation2Los valores de lectura se giran en función del ángulo de la propiedad « userOrientation ».

Véase también QSensor::axesOrientationMode.

enum QSensor::Feature

Enumera las funciones opcionales que un backend podría admitir.

Las características comunes a todos los tipos de sensores son:

ConstanteValorDescripción
QSensor::Buffering0El backend admite el almacenamiento en búfer de las lecturas, controlado por la propiedad « QSensor::bufferSize ».
QSensor::AlwaysOn1El backend admite la modificación de la política sobre si suspender o no la actividad en caso de inactividad, controlada por la propiedad ` QSensor::alwaysOn `.
QSensor::SkipDuplicates5El backend admite la omisión de lecturas sucesivas iguales o muy similares. Esto se puede habilitar estableciendo la propiedad ` QSensor::skipDuplicates ` en `true`.

Las características de ` QMagnetometer ` son:

ConstanteValorDescripción
QSensor::GeoValues2El backend admite la devolución de valores geográficos, que se pueden controlar mediante la propiedad QMagnetometer::returnGeoValues.

Las características de ` QLightSensor ` son:

ConstanteValorDescripción
QSensor::FieldOfView3El backend especifica su campo de visión, que puede consultarse en la propiedad « QLightSensor::fieldOfView ».

Las características de « QAccelerometer » son:

ConstanteValorDescripción
QSensor::AccelerationMode4El backend permite cambiar el modo de aceleración del acelerómetro mediante la propiedad ` QAccelerometer::accelerationMode `.

Las características de « QPressureSensor » son:

ConstanteValorDescripción
QSensor::PressureSensorTemperature7El backend proporciona la temperatura del chip del sensor de presión

Las características de todos los sensores orientables son:

ConstanteValorDescripción
QSensor::AxesOrientation6El backend permite cambiar la orientación de los ejes desde la predeterminada ( QSensor::FixedOrientation ) a otra diferente.

Véase también QSensor::isFeatureSupported().

Documentación de la propiedad

active : bool

Esta propiedad contiene un valor que indica si el sensor está activo.

Este valor es «true» si el sensor está activo (devolviendo valores). En caso contrario, es «false».

Ten en cuenta que establecer este valor en «true» no tendrá un efecto inmediato. En su lugar, el sensor se iniciará una vez que se haya alcanzado el bucle de eventos.

Funciones de acceso:

bool isActive() const
void setActive(bool active)

Señal del notificador:

void activeChanged()

alwaysOn : bool

Esta propiedad contiene un valor que indica si el sensor debe seguir funcionando cuando la pantalla está apagada.

Algunas plataformas tienen la política de suspender los sensores cuando se apaga la pantalla. Al establecer esta propiedad en «true», se garantiza que el sensor siga funcionando.

Funciones de acceso:

bool isAlwaysOn() const
void setAlwaysOn(bool alwaysOn)

Señal de notificación:

[read-only] availableDataRates : qrangelist

Esta propiedad contiene las velocidades de transmisión de datos que admite el sensor.

Esta es una lista de las velocidades de transmisión de datos que admite el sensor. Se miden en hercios.

Las entradas de la lista pueden representar velocidades discretas o un rango continuo de velocidades. Una velocidad discreta se identifica porque ambos valores son iguales.

Ten en cuenta que esta información no es obligatoria, ya que no todos los sensores tienen una velocidad a la que funcionan. En tales casos, la lista estará vacía.

Funciones de acceso:

qrangelist availableDataRates() const

Véase también QSensor::dataRate y qrangelist.

axesOrientationMode : AxesOrientationMode

Esta propiedad define el modo que determina cómo cambia la orientación de la pantalla al leer los valores.

Cuando se establece en « FixedOrientation », que es el modo predeterminado, no se aplica ninguna rotación automática a la lectura. Este es el único modo disponible para los backends que no admiten la función « QSensor::AxesOrientation ».

Cuando se establece en « AutomaticOrientation », los valores de lectura se giran automáticamente al cambiar la orientación de la pantalla. En la práctica, la orientación de la pantalla queda anulada.

A modo de ejemplo, supongamos que el dispositivo se gira 180 grados y, por lo tanto, la orientación de la pantalla también gira 180 grados con respecto a la orientación nativa. Sin la orientación automática de los ejes, los valores de lectura se verían alterados: tanto los valores X como los Y se invertirían, lo que obligaría al desarrollador de la aplicación a anular manualmente dicha inversión en el código de la aplicación. La orientación automática de los ejes lo hace de forma automática; en este modo, los valores X e Y serían los mismos que con la orientación predeterminada de la pantalla.

Esta rotación automática de los ejes resulta útil en algunos casos de uso, por ejemplo, en una aplicación de nivel de burbuja que mide el nivel de una superficie observando el valor del eje X de un acelerómetro. Cuando la orientación del dispositivo y de la pantalla cambia 90 grados, el desarrollador de la aplicación no tiene que modificar nada; puede seguir utilizando el valor del eje X aunque el dispositivo se haya girado. Sin la orientación automática de los ejes, el desarrollador tendría que fijarse en los valores de Y, lo que supondría añadir código a la aplicación para que lea datos de un eje diferente en función de la orientación de la pantalla.

El modo « UserOrientation » es bastante similar al de « AutomaticOrientation », con la única diferencia de que la orientación de la pantalla se controla manualmente en lugar de determinarse automáticamente. El ángulo de la propiedad « userOrientation » se utiliza entonces para rotar los valores de lectura.

Dado que la rotación de los valores de lectura se basa en la orientación de la pantalla, los valores Z nunca cambiarán, ya que el eje Z es perpendicular a la pantalla. Como la orientación de la pantalla cambia en incrementos de 90 grados, la rotación de los valores de lectura también se realiza en incrementos de 90 grados.

Esta propiedad solo se utiliza para sensores orientables.

Funciones de acceso:

QSensor::AxesOrientationMode axesOrientationMode() const
void setAxesOrientationMode(QSensor::AxesOrientationMode axesOrientationMode)

Señal de notificación:

void axesOrientationModeChanged(QSensor::AxesOrientationMode axesOrientationMode)

bufferSize : int

Esta propiedad indica el tamaño del búfer. Por defecto, el tamaño del búfer es 1, lo que significa que no hay almacenamiento en búfer. Si el tamaño máximo del búfer es 1, el sensor no admite el almacenamiento en búfer.

Si se establece bufferSize en un valor superior a maxBufferSize, se utilizará la función « maxBufferSize ».

El almacenamiento en búfer se activa cuando bufferSize es mayor que 1. El sensor recopilará el número de muestras solicitado y las enviará todas a la aplicación de una sola vez. Se enviarán a la aplicación como una ráfaga de lecturas modificadas, por lo que es especialmente importante que la aplicación procese cada lectura de inmediato o guarde los valores en otro lugar.

Si se llama a stop() mientras el almacenamiento en búfer está en curso, el búfer parcial no se envía.

Cuando el sensor se inicia con la opción de almacenamiento en búfer, los valores se recogen a partir de ese momento. No existe ningún búfer preexistente que se pueda utilizar.

Algunos backends solo admiten la activación o desactivación del almacenamiento en búfer y no permiten controlar su tamaño. En este caso, es posible que las propiedades ` maxBufferSize ` y ` efficientBufferSize ` no se puedan configurar en absoluto, aunque se admita el almacenamiento en búfer. Al establecer la propiedad `bufferSize` en cualquier valor superior a 1, se activará el almacenamiento en búfer. Una vez iniciado el sensor, el backend establecerá la propiedad bufferSize en el valor real.

Funciones de acceso:

int bufferSize() const
void setBufferSize(int bufferSize)

Señal de notificación:

void bufferSizeChanged(int bufferSize)

Véase también QSensor::maxBufferSize y QSensor::efficientBufferSize.

[read-only] busy : bool

Esta propiedad contiene un valor que indica si el sensor está ocupado.

Es posible que haya sensores en el sistema que no estén disponibles para su uso. Esta función devolverá «true» si el sensor está ocupado. No podrás utilizar la función ` start()` con ese sensor.

Ten en cuenta que esta función no devuelve «true» si estás utilizando el sensor, sino solo si otro proceso lo está utilizando.

Funciones de acceso:

bool isBusy() const

Señal de notificación:

void busyChanged()

Véase también ` busyChanged()`.

[read-only] connectedToBackend : bool

Esta propiedad contiene un valor que indica si el sensor se ha conectado a un servidor.

Un sensor que no se haya conectado a un backend no puede realizar ninguna acción útil.

Llama al método ` connectToBackend()` para forzar que el sensor se conecte a un backend inmediatamente. Este método se invoca automáticamente si llamas a ` start()`, por lo que solo debes hacerlo si necesitas acceder a las propiedades del sensor (por ejemplo, para consultar los metadatos del sensor antes de utilizarlo).

Funciones de acceso:

bool isConnectedToBackend() const

[read-only] currentOrientation : int

Esta propiedad contiene la orientación actual que se utiliza para rotar los valores de lectura.

Es posible que no coincida con la orientación de la pantalla. Por ejemplo, en el modo « FixedOrientation », los valores de lectura no se giran y, por lo tanto, la propiedad es 0.

En el modo « UserOrientation », las lecturas se giran en función de la propiedad « userOrientation » y, por lo tanto, esta propiedad es igual a la propiedad « userOrientation ».

En el modo « AutomaticOrientation », las lecturas se giran en función de la orientación de la pantalla y, por lo tanto, esta propiedad será igual a la orientación actual de la pantalla.

Esta propiedad la establece el backend y solo es válida para sensores orientables.

Funciones de acceso:

int currentOrientation() const

Señal de notificación:

void currentOrientationChanged(int currentOrientation)

dataRate : int

Esta propiedad indica la velocidad de transmisión a la que debe funcionar el sensor.

Se mide en hercios.

La frecuencia de datos es la frecuencia máxima a la que el sensor puede detectar cambios.

La configuración de esta propiedad no es portátil y puede provocar conflictos con otras aplicaciones. Consulta la documentación del backend del sensor y de la plataforma para conocer las políticas relativas a la solicitud de una tasa de datos por parte de varias aplicaciones.

El valor por defecto (0) significa que a la aplicación no le importa cuál sea la velocidad de transmisión de datos. Las aplicaciones deberían plantearse utilizar una consulta basada en un temporizador del valor actual o asegurarse de que el código que procesa los valores pueda ejecutarse muy rápidamente, ya que la plataforma puede proporcionar actualizaciones cientos de veces por segundo.

Esto debe configurarse antes de llamar a ` start()``, ya que es posible que el sensor no detecte cambios en este valor mientras está en ejecución.

Ten en cuenta que no existe ningún mecanismo para determinar la velocidad de transmisión de datos que está utilizando actualmente la plataforma.

Funciones de acceso:

int dataRate() const
void setDataRate(int rate)

Señal de notificación:

void dataRateChanged()

Véase también QSensor::availableDataRates.

[read-only] description : QString

Esta propiedad contiene una cadena descriptiva del sensor.

Funciones de acceso:

QString description() const

[read-only] efficientBufferSize : int

Esta propiedad indica el tamaño de búfer más eficiente. Normalmente es 1 (lo que significa que no hay un tamaño concreto que sea más eficiente). Algunos controladores de sensores cuentan con un búfer FIFO, por lo que resulta más eficiente enviar de una sola vez el número de lecturas correspondiente al tamaño de dicho búfer.

Funciones de acceso:

int efficientBufferSize() const

Señal de notificación:

void efficientBufferSizeChanged(int efficientBufferSize)

Véase también QSensor::bufferSize y QSensor::maxBufferSize.

[read-only] error : int

Esta propiedad contiene el último código de error registrado en el sensor.

Ten en cuenta que los códigos de error son específicos de cada sensor.

Funciones de acceso:

int error() const

Señal de notificación:

void sensorError(int error)

identifier : QByteArray

Esta propiedad contiene el identificador del backend del sensor.

Ten en cuenta que el identificador se rellena automáticamente cuando el sensor se conecta a un backend. Si deseas conectar un backend específico, debes llamar a `setIdentifier()` antes de ` connectToBackend()`.

Funciones de acceso:

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

Señal de notificación:

void identifierChanged()

[read-only] maxBufferSize : int

Esta propiedad indica el tamaño máximo del búfer.

Ten en cuenta que este valor puede ser 1; en ese caso, el sensor no admite ningún tipo de almacenamiento en búfer. En tal caso, la función « isFeatureSupported » (QSensor::Buffering) también devolverá «false».

Funciones de acceso:

int maxBufferSize() const

Señal de notificación:

void maxBufferSizeChanged(int maxBufferSize)

Véase también QSensor::bufferSize y QSensor::efficientBufferSize.

outputRange : int

Esta propiedad contiene el rango de salida que utiliza el sensor.

Este valor representa el índice de la lista « QSensor::outputRanges » que se va a utilizar.

La configuración de esta propiedad no es portátil y puede provocar conflictos con otras aplicaciones. Consulta la documentación del backend del sensor y de la plataforma para conocer las políticas relativas a la solicitud de un rango de salida por parte de varias aplicaciones.

El valor por defecto (-1) significa que a la aplicación no le importa cuál sea el rango de salida.

Ten en cuenta que no existe ningún mecanismo para determinar el rango de salida que está utilizando actualmente la plataforma.

Funciones de acceso:

int outputRange() const
void setOutputRange(int index)

Véase también QSensor::outputRanges.

[read-only] outputRanges : qoutputrangelist

Esta propiedad contiene una lista de los rangos de salida que admite el sensor.

Un sensor puede tener más de un rango de salida. Normalmente, esto se hace para obtener un mayor rango de medición a costa de reducir la precisión.

Ten en cuenta que esta información no es obligatoria. Por lo general, solo está disponible para los sensores que tienen rangos de salida seleccionables (como los acelerómetros habituales).

Funciones de acceso:

qoutputrangelist outputRanges() const

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

[read-only] reading : QSensorReading*

Esta propiedad contiene la clase de lectura.

La clase «reading» proporciona acceso a las lecturas de los sensores. El objeto «reading» es una caché volátil de la lectura más reciente del sensor que se ha recibido, por lo que la aplicación debe procesar las lecturas inmediatamente o guardar los valores en algún lugar para su procesamiento posterior.

Ten en cuenta que esto devolverá 0 hasta que se conecte un backend de sensor a un backend.

Tenga en cuenta también que las lecturas no están disponibles de inmediato tras llamar a ` start()`. Las aplicaciones deben esperar a que se emita la señal ` readingChanged()`.

Funciones de acceso:

QSensorReading *reading() const

Señal de notificación:

Véanse también isConnectedToBackend() y start().

skipDuplicates : bool

Indica si deben omitirse los valores de lectura duplicados.

Cuando se activa la omisión de duplicados, se omiten las lecturas sucesivas con valores iguales o muy similares. Esto ayuda a reducir la carga de procesamiento, ya que se dispone de menos lecturas del sensor. Como consecuencia, las lecturas llegan a intervalos irregulares.

La omisión de duplicados no solo se activa para lecturas que son exactamente iguales, sino también para lecturas bastante similares, ya que cada sensor presenta una ligera fluctuación aunque el dispositivo no se mueva.

La compatibilidad con esta propiedad depende del backend. Utiliza isFeatureSupported() para comprobar si es compatible con la plataforma actual.

La omisión de duplicados está desactivada por defecto.

La omisión de duplicados surte efecto cuando se inicia el sensor; cambiar la propiedad mientras el sensor está activo no tiene ningún efecto inmediato.

Funciones de acceso:

bool skipDuplicates() const
void setSkipDuplicates(bool skipDuplicates)

Señal de notificación:

void skipDuplicatesChanged(bool skipDuplicates)

[read-only] type : const QByteArray

Esta propiedad contiene el tipo del sensor.

Funciones de acceso:

QByteArray type() const

userOrientation : int

Esta propiedad almacena el ángulo que se utiliza para rotar los valores de lectura en el modo « UserOrientation ».

Cuando la propiedad « axesOrientationMode » se establece en « UserOrientation », el ángulo de rotación de los valores de lectura se toma de esta propiedad. En los demás modos, la propiedad no tiene ningún efecto.

El valor por defecto es 0. Los únicos valores válidos son 0, 90, 180 y 270, ya que esas son las únicas orientaciones posibles de la pantalla.

Esta propiedad solo es válida para sensores orientables.

Funciones de acceso:

int userOrientation() const
void setUserOrientation(int userOrientation)

Señal de notificación:

void userOrientationChanged(int userOrientation)

Documentación de las funciones de miembro

[explicit] QSensor::QSensor(const QByteArray &type, QObject *parent = nullptr)

Crea el sensor « type » como un elemento secundario de « parent ».

No utilices este constructor si existe una clase derivada para ese tipo de sensor concreto.

La forma incorrecta es utilizar el constructor de la clase base:

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

La forma correcta es crear una instancia de la clase derivada:

QMagnetometer *magnetometer = new QMagnetometer(this);

Las clases derivadas tienen propiedades y miembros de datos adicionales que son necesarios para ciertas funciones, como la compatibilidad con valores geográficos en QMagnetometer o la compatibilidad con el modo de aceleración en QAccelerometer. Estas funciones solo funcionarán correctamente al crear una instancia de sensor a partir de una subclase de QSensor.

Utiliza este constructor únicamente si no hay ninguna clase de sensor derivada disponible. Ten en cuenta que todos los sensores integrados tienen una clase derivada, por lo que el uso de este constructor solo debería ser necesario al implementar sensores personalizados.

[virtual noexcept] QSensor::~QSensor()

Destruye el sensor. Detiene el sensor si aún no se ha detenido.

[signal] void QSensor::activeChanged()

Esta señal se emite cuando la propiedad QSensor::active ha cambiado.

Nota: Señalde notificador para la propiedad active.

Véase también QSensor::active.

void QSensor::addFilter(QSensorFilter *filter)

Añade un « filter » al sensor.

El sensor no se hace cargo del filtro. « QSensorFilter » informará al sensor si este se destruye.

Véase también « QSensorFilter ».

[signal] void QSensor::alwaysOnChanged()

Esta señal se emite cuando cambia la propiedad alwaysOn.

Nota: Señalde notificación para la propiedad alwaysOn.

[signal] void QSensor::availableSensorsChanged()

Esta señal se emite cuando cambia la lista de sensores disponibles. Por lo general, los sensores disponibles para un programa no cambian con el tiempo; sin embargo, algunos de ellos pueden corresponder a hardware que no está conectado de forma permanente. Por ejemplo, un mando de videojuegos conectado por Bluetooth estaría disponible cuando estuviera encendido y dejaría de estarlo cuando se apagara.

Véase también QSensor::sensorTypes() y QSensor::sensorsForType().

[signal] void QSensor::busyChanged()

Esta señal se emite cuando el sensor ya no está ocupado. Se puede utilizar para adquirir un sensor cuando esté disponible.

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

Nota: Señalde notificación para la propiedad « busy ».

[invokable] bool QSensor::connectToBackend()

Intenta conectarte a un backend de sensores.

Devuelve «true» si se ha encontrado un backend adecuado; en caso contrario, devuelve «false».

Si se utiliza directamente QSensor, se debe establecer el tipo antes de llamar a este método.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Véase también isConnectedToBackend().

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

Devuelve el identificador de sensor predeterminado para type. Este se configura en un archivo de configuración y puede sobrescribirse si es necesario. Si no hay ningún valor predeterminado disponible, el sistema devolverá el primer sensor registrado para type.

Ten en cuenta que existe una lógica especial para evitar que los backends del plugin genérico se conviertan en los predeterminados cuando se haya registrado otro backend para el mismo tipo. Esta lógica implica que un identificador de backend que comience por generic. solo será el predeterminado si no se han registrado otros backends para ese tipo o si así se especifica en Sensors.conf.

Véase también «Determinación del sensor predeterminado para un tipo».

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

Devuelve los filtros asociados actualmente al sensor.

Véase también QSensorFilter.

[invokable] bool QSensor::isFeatureSupported(QSensor::Feature feature) const

Comprueba si el backend admite una función concreta.

QtSensors Ofrece una API completa para controlar y proporcionar información sobre los sensores. Como es lógico, no todas las funcionalidades son compatibles con todos los backends.

Para comprobar si el backend actual admite la función feature, llama a esta función.

El backend debe estar conectado; de lo contrario, se devolverá «false». Al llamar a connectToBackend() o start(), se establecerá una conexión con el backend.

Los backends deben implementar QSensorBackend::isFeatureSupported() para que esto funcione.

Devuelve si la función es compatible o no si el backend está conectado, o «false» si el backend no está conectado.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[signal] void QSensor::readingChanged()

Esta señal se emite cuando se recibe una nueva lectura del sensor.

La lectura del sensor se puede encontrar en la propiedad « QSensor::reading ». Ten en cuenta que el objeto de lectura es una caché volátil de la lectura más reciente del sensor que se ha recibido, por lo que la aplicación debe procesar la lectura inmediatamente o guardar los valores en algún lugar para su procesamiento posterior.

Antes de que esta señal se haya emitido por primera vez, el objeto de lectura contendrá datos no inicializados.

Nota: Señalde notificador para la propiedad ` reading`.

Véase también start().

void QSensor::removeFilter(QSensorFilter *filter)

Retira el filter del sensor.

Véase también « QSensorFilter ».

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

Esta señal se emite cuando se establece un código « error » en el sensor. Ten en cuenta que algunos errores provocarán que el sensor deje de funcionar. Debes llamar a isActive() para comprobar si el sensor sigue funcionando.

Nota: Señalde notificación para la propiedad error.

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

Devuelve una lista con todos los tipos de sensores.

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

Devuelve una lista con los identificadores de cada uno de los sensores de type. Si no hay sensores de ese tipo disponibles, la lista estará vacía.

void QSensor::setCurrentOrientation(int currentOrientation)

Establece la orientación actual de la pantalla en « currentOrientation ». Esta función debe llamarse desde el backend cada vez que cambie la orientación de la pantalla o la propiedad « userOrientation ».

Véase también currentOrientation().

void QSensor::setEfficientBufferSize(int efficientBufferSize)

Establece el tamaño del búfer eficiente en efficientBufferSize. Esta función debe llamarse desde el backend.

Véase también efficientBufferSize().

void QSensor::setMaxBufferSize(int maxBufferSize)

Establece el tamaño máximo del búfer en maxBufferSize. Esta función debe llamarse desde el backend.

Véase también maxBufferSize().

void QSensor::setSkipDuplicates(bool skipDuplicates)

Establece la opción de omitir duplicados en ` skipDuplicates`.

Nota: Funciónde asignación para la propiedad ` skipDuplicates`.

Véase también ` skipDuplicates()`.

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

Esta señal se emite cuando cambia la propiedad « skipDuplicates ».

Nota: Señalde notificación para la propiedad skipDuplicates.

[slot] bool QSensor::start()

Inicia la lectura de valores del sensor. Devuelve «true» si el sensor se ha iniciado; en caso contrario, devuelve «false».

El sensor puede no iniciarse por varias razones.

Una vez que una aplicación ha iniciado un sensor, debe esperar a que este reciba un nuevo valor antes de poder consultar los valores del sensor. Esto se debe a la forma en que el sensor recibe los valores del sistema. Los sensores no suelen solicitar nuevos valores de forma activa, sino que estos se envían a los sensores a medida que se producen.

Por ejemplo, este código no funcionará como se espera.

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

Para que funcione correctamente, el código que accede a la lectura debe asegurarse de que se haya emitido la señal « readingChanged()».

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

Véase también QSensor::busy.

[slot] void QSensor::stop()

Deja de recuperar valores del sensor.

De este modo, se libera el sensor para que otros procesos puedan utilizarlo.

Véase también QSensor::busy.

Elementos no miembros relacionados

[alias] qoutputrangelist

Este tipo se define como una lista de valores de qoutputrange.

typedef QList<qoutputrange> qoutputrangelist;

Véase también QList, qoutputrange y QSensor::outputRanges.

[alias] qrange

Este tipo se define como un « QPair ».

typedef QPair<int,int> qrange;

Véase también QPair, qrangelist y QSensor::availableDataRates.

[alias] qrangelist

Este tipo se define como una lista de valores de qrange.

typedef QList<qrange> qrangelist;

Véase también QList, qrange y QSensor::availableDataRates.

© 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.