QSensor Class

Documentación de propiedades

active : bool

Esta propiedad contiene un valor para indicar si el sensor está activo.

Es true si el sensor está activo (devolviendo valores). Es false en caso contrario.

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

Funciones de acceso:

Señal del notificador:

alwaysOn : bool

Esta propiedad contiene un valor para indicar si el sensor debe permanecer funcionando cuando la pantalla está apagada.

Algunas plataformas tienen una política de suspender los sensores cuando la pantalla se apaga. Establecer esta propiedad a true asegurará que el sensor continúe funcionando.

Funciones de acceso:

Señal del notificador:

[read-only] availableDataRates : qrangelist

Esta propiedad contiene las velocidades de datos que soporta el sensor.

Esta es una lista de las velocidades de datos que soporta el sensor. Medido en Hertz.

Las entradas en la lista pueden representar tasas discretas o un rango continuo de tasas. Una tasa discreta se nota por tener ambos valores iguales.

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

Funciones de acceso:

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

axesOrientationMode : AxesOrientationMode

Esta propiedad contiene el modo que afecta a cómo la orientación de la pantalla cambia los valores de lectura.

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

Si se selecciona AutomaticOrientation, los valores de lectura se rotan automáticamente cuando cambia la orientación de la pantalla. En efecto, la orientación de la pantalla se anula.

Como ejemplo, supongamos que el dispositivo se gira 180 grados y, por lo tanto, la orientación de la pantalla también se gira 180 grados con respecto a la orientación nativa. Sin la orientación automática de los ejes, los valores de lectura cambiarían: tanto el valor X como el Y se negarían, forzando al desarrollador de aplicaciones a cancelar manualmente la negación en el código de la aplicación. La orientación automática de los ejes hace esto automáticamente, en este modo los valores X e Y serían los mismos que con la orientación por defecto de la pantalla.

Esta rotación automática de los ejes es útil en algunos casos, por ejemplo en una aplicación de nivel de burbuja que mide el nivel de una superficie mirando el valor del eje X de un acelerómetro. Cuando el dispositivo y la orientación de la pantalla cambian 90 grados, un desarrollador de aplicaciones no necesita cambiar nada, puede seguir utilizando el valor del eje X aunque el dispositivo esté rotado. Sin la orientación automática de los ejes, el desarrollador de aplicaciones tendría que mirar los valores Y en su lugar, añadiendo así código a la aplicación que lee de un eje diferente dependiendo de la orientación de la pantalla.

El modo UserOrientation es bastante similar a AutomaticOrientation, sólo 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 pasos de 90 grados, la rotación de los valores de lectura también se realiza en pasos de 90 grados.

Esta propiedad sólo se utiliza para sensores orientables.

Funciones de acceso:

Señal del notificador:

bufferSize : int

Esta propiedad contiene el tamaño del búfer. Por defecto, el tamaño del buffer es 1, lo que significa que no hay buffering. Si el tamaño máximo del buffer es 1, entonces el buffering no es soportado por el sensor.

Poniendo bufferSize mayor que maxBufferSize causará que maxBufferSize sea usado.

El buffering se activa cuando bufferSize es mayor que 1. El sensor recogerá el número solicitado de muestras y las entregará todas a la aplicación de una vez. Serán entregadas a la aplicación como una ráfaga de lecturas cambiadas así que es particularmente importante que la aplicación procese cada lectura inmediatamente o guarde los valores en algún otro lugar.

Si stop() es llamado cuando el buffer está en curso, el buffer parcial no es entregado.

Cuando el sensor se inicia con la opción de buffering, los valores se recogen a partir de ese momento. No hay un buffer pre-existente que pueda ser utilizado.

Algunos backends sólo soportan habilitar o deshabilitar el buffer y no dan control sobre el tamaño. En este caso, es posible que las propiedades maxBufferSize y efficientBufferSize no se establezcan en absoluto, aunque se admita el almacenamiento en búfer. Establecer la propiedad bufferSize a cualquier valor mayor que 1 habilitará el buffering. Después de que el sensor haya sido iniciado, la propiedad bufferSize será establecida al valor actual por el backend.

Funciones de acceso:

Señal notificadora:

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

[read-only] busy : bool

Esta propiedad contiene un valor para indicar si el sensor está ocupado.

Algunos sensores pueden estar en el sistema pero no disponibles para su uso. Esta función regresará true si el sensor está ocupado. Usted no podrá start() el sensor.

Note que esta función no regresa true si usted está usando el sensor, sólo si otro proceso está usando el sensor.

Funciones de acceso:

Señal de notificador:

Véase también busyChanged().

[read-only] connectedToBackend : bool

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

Un sensor que no ha sido conectado a un backend no puede hacer nada útil.

Llame al método connectToBackend() para forzar al sensor a conectarse a un backend inmediatamente. Se llama automáticamente si se llama a start(), así que sólo es necesario hacerlo si se necesita acceder a las propiedades del sensor (por ejemplo, para sondear los metadatos del sensor antes de usarlo).

Funciones de acceso:

[read-only] currentOrientation : int

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

Puede no coincidir con la orientación de la pantalla. Por ejemplo, en el modo FixedOrientation, los valores de lectura no se rotan, y por lo tanto la propiedad es 0.

En el modo UserOrientation, las lecturas se rotan basándose en la propiedad userOrientation, y por lo tanto esta propiedad es igual a la propiedad userOrientation.

En el modo AutomaticOrientation, las lecturas se rotan basándose en 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 sólo es válida para sensores orientables.

Funciones de acceso:

Señal del notificador:

dataRate : int

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

Se mide en hercios.

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

Establecer esta propiedad no es portable y puede causar conflictos con otras aplicaciones. Verifique con la documentación del sensor y la plataforma para cualquier política con respecto a múltiples aplicaciones solicitando una tasa de datos.

El valor por defecto (0) significa que a la aplicación no le importa cual es la tasa de datos. Las aplicaciones deberían considerar el uso de un sondeo basado en temporizador del valor actual o asegurarse de que el código que procesa los valores puede ejecutarse muy rápidamente ya que la plataforma puede proporcionar actualizaciones cientos de veces cada segundo.

Esto debería establecerse antes de llamar a start() porque el sensor puede no notar cambios en este valor mientras se está ejecutando.

Tenga en cuenta que no hay ningún mecanismo para determinar la velocidad de datos actual en uso por la plataforma.

Funciones de acceso:

Señal del notificador:

Véase también QSensor::availableDataRates.

[read-only] description : QString

Esta propiedad contiene una cadena descriptiva del sensor.

Funciones de acceso:

[read-only] efficientBufferSize : int

La propiedad contiene el tamaño de búfer más eficiente. Normalmente es 1 (lo que significa que ningún tamaño en particular es el más eficiente). Algunos controladores de sensor tienen un buffer FIFO que hace más eficiente entregar el tamaño FIFO de lecturas de una sola vez.

Funciones de acceso:

Señal notificadora:

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

[read-only] error : int

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

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

Funciones de acceso:

Señal del notificador:

identifier : QByteArray

Esta propiedad contiene el identificador de backend para el sensor.

Tenga en cuenta que el identificador se rellena automáticamente cuando el sensor se conecta a un backend. Si quieres conectar un backend específico, deberías llamar a setIdentifier() antes de connectToBackend().

Funciones de acceso:

Señal del notificador:

[read-only] maxBufferSize : int

La propiedad contiene el tamaño máximo del buffer.

Tenga en cuenta que puede ser 1, en cuyo caso el sensor no soporta ninguna forma de buffering. En ese caso, isFeatureSupported(QSensor::Buffering) también devolverá false.

Funciones de acceso:

Señal de notificador:

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

outputRange : int

Esta propiedad contiene el rango de salida en uso por el sensor.

Este valor representa el índice en la lista QSensor::outputRanges a utilizar.

Establecer esta propiedad no es portable y puede causar conflictos con otras aplicaciones. Compruebe con la documentación del sensor y la plataforma para cualquier política con respecto a múltiples aplicaciones solicitando un rango de salida.

El valor por defecto (-1) significa que a la aplicación no le importa cual es el rango de salida.

Tenga en cuenta que no hay ningún mecanismo para determinar el rango de salida actual en uso por la plataforma.

Funciones de acceso:

Véase también QSensor::outputRanges.

[read-only] outputRanges : qoutputrangelist

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

Un sensor puede tener más de un rango de salida. Típicamente esto se hace para dar un mayor rango de medida a costa de reducir la precisión.

Note que esta información no es obligatoria. Esta información normalmente sólo está disponible para sensores que tienen rangos de salida seleccionables (como los típicos acelerómetros).

Funciones de acceso:

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

[read-only] reading : QSensorReading*

Esta propiedad contiene la clase de lectura.

La clase de lectura proporciona acceso a las lecturas del sensor. El objeto de lectura es una caché volátil de la lectura de sensor más reciente que se ha recibido, por lo que la aplicación debería procesar las lecturas inmediatamente o guardar los valores en algún lugar para procesarlos más tarde.

Tenga en cuenta que esto devolverá 0 hasta que un sensor backend esté conectado a un backend.

También hay que tener en cuenta que las lecturas no están disponibles inmediatamente después de llamar a start(). Las aplicaciones deben esperar a que se emita la señal readingChanged().

Funciones de acceso:

Señal de notificador:

Véase 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 cantidad de procesamiento realizado, ya que se dispone de menos lecturas del sensor. Como consecuencia, las lecturas llegan a intervalos irregulares.

La omisión de duplicados no sólo se activa para lecturas que son exactamente iguales, sino también para lecturas que son bastante similares, ya que cada sensor tiene un poco de fluctuación aunque el dispositivo no se mueva.

El soporte de esta propiedad depende del backend. Utilice isFeatureSupported() para comprobar si es compatible con la plataforma actual.

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

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

Funciones de acceso:

Señal del notificador:

[read-only] type : const QByteArray

Esta propiedad contiene el tipo de sensor.

Funciones de acceso:

userOrientation : int

Esta propiedad contiene el ángulo utilizado para rotar los valores de lectura en el modo UserOrientation.

Cuando la propiedad axesOrientationMode se establece en UserOrientation, el ángulo para rotar los valores de lectura se toma de esta propiedad. En otros modos, la propiedad no tiene efecto.

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

Esta propiedad sólo es válida para sensores orientables.

Funciones de acceso:

Señal del notificador:

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;