QSensor Class

Propriété Documentation

active : bool

Cette propriété contient une valeur indiquant si le capteur est actif.

Cette valeur est vraie si le capteur est actif (il renvoie des valeurs). Dans le cas contraire, cette valeur est fausse.

Notez que la définition de cette valeur à true n'aura pas d'effet immédiat. Au lieu de cela, le capteur sera démarré une fois que la boucle d'événement aura été atteinte.

Fonctions d'accès :

Signal de notification :

alwaysOn : bool

Cette propriété contient une valeur indiquant si le capteur doit continuer à fonctionner lorsque l'écran est éteint.

Certaines plateformes ont pour politique de suspendre les capteurs lorsque l'écran s'éteint. En définissant cette propriété à true, vous vous assurez que le capteur continue à fonctionner.

Fonctions d'accès :

Notificateur signal :

[read-only] availableDataRates : qrangelist

Cette propriété contient les débits de données pris en charge par le capteur.

Il s'agit d'une liste des débits de données pris en charge par le capteur. Ils sont mesurés en Hertz.

Les entrées de la liste peuvent représenter des débits discrets ou une gamme continue de débits. Un débit discret est indiqué par le fait que les deux valeurs sont identiques.

Notez que cette information n'est pas obligatoire, car tous les capteurs n'ont pas un taux auquel ils fonctionnent. Dans ce cas, la liste sera vide.

Fonctions d'accès :

Voir également QSensor::dataRate et qrangelist.

axesOrientationMode : AxesOrientationMode

Cette propriété contient le mode qui affecte la façon dont l'orientation de l'écran modifie les valeurs de lecture.

Lorsque la propriété vaut FixedOrientation, qui est le mode par défaut, aucune rotation automatique n'est appliquée à la lecture. C'est le seul mode disponible pour les backends qui ne prennent pas en charge la fonctionnalité QSensor::AxesOrientation.

Lorsque l'option AutomaticOrientation est sélectionnée, les valeurs de lecture sont automatiquement pivotées lorsque l'orientation de l'écran change. En fait, l'orientation de l'écran est annulée.

À titre d'exemple, supposons que l'appareil soit tourné de 180 degrés et que l'orientation de l'écran soit également tournée de 180 degrés par rapport à l'orientation d'origine. Sans l'orientation automatique des axes, les valeurs de lecture seraient modifiées : les valeurs X et Y seraient annulées, ce qui obligerait le développeur de l'application à annuler manuellement la négation dans le code de l'application. L'orientation automatique des axes effectue cette opération automatiquement. Dans ce mode, les valeurs X et Y sont identiques à celles de l'orientation par défaut de l'écran.

Cette rotation automatique des axes est pratique dans certains cas d'utilisation, par exemple dans une application de niveau à bulle qui mesure le niveau d'une surface en regardant la valeur de l'axe X d'un accéléromètre. Lorsque l'appareil et l'orientation de l'écran changent de 90 degrés, le développeur de l'application n'a pas besoin de changer quoi que ce soit, il peut continuer à utiliser la valeur de l'axe X même si l'appareil est tourné. Sans l'orientation automatique des axes, le développeur d'applications devrait regarder les valeurs Y à la place, ajoutant ainsi du code à l'application qui lit un axe différent en fonction de l'orientation de l'écran.

Le mode UserOrientation est assez similaire au mode AutomaticOrientation, à ceci près que l'orientation de l'écran est contrôlée manuellement au lieu d'être déterminée automatiquement. L'angle de la propriété userOrientation est alors utilisé pour faire pivoter les valeurs de lecture.

Comme la rotation des valeurs de lecture est basée sur l'orientation de l'écran, les valeurs Z ne changeront jamais, car l'axe Z est perpendiculaire à l'écran. Comme l'orientation de l'écran change par pas de 90 degrés, la rotation des valeurs de lecture se fait également par pas de 90 degrés.

Cette propriété n'est utilisée que pour les capteurs orientables.

Fonctions d'accès :

Signal de notification :

bufferSize : int

Cette propriété indique la taille de la mémoire tampon. Par défaut, la taille de la mémoire tampon est de 1, ce qui signifie qu'il n'y a pas de mise en mémoire tampon. Si la taille maximale de la mémoire tampon est de 1, cela signifie que la mémoire tampon n'est pas prise en charge par le capteur.

Si la valeur de bufferSize est supérieure à maxBufferSize, maxBufferSize sera utilisé.

La mise en mémoire tampon est activée lorsque bufferSize est supérieur à 1. Le capteur collectera le nombre d'échantillons demandé et les transmettra tous à l'application en une seule fois. Il est donc particulièrement important que l'application traite chaque lecture immédiatement ou enregistre les valeurs à un autre endroit.

Si stop() est appelé lorsque la mise en mémoire tampon est en cours, la mémoire tampon partielle n'est pas délivrée.

Lorsque le capteur est démarré avec l'option de mise en mémoire tampon, les valeurs sont collectées à partir de ce moment. Il n'y a pas de tampon préexistant qui puisse être utilisé.

Certains backends ne prennent en charge que l'activation ou la désactivation de la mémoire tampon et ne permettent pas d'en contrôler la taille. Dans ce cas, les propriétés maxBufferSize et efficientBufferSize peuvent ne pas être définies du tout, même si la mise en mémoire tampon est prise en charge. La définition de la propriété bufferSize à une valeur supérieure à 1 activera la mise en mémoire tampon. Après le démarrage du capteur, la propriété bufferSize sera fixée à la valeur réelle par le backend.

Fonctions d'accès :

Signal de notification :

Voir aussi QSensor::maxBufferSize et QSensor::efficientBufferSize.

[read-only] busy : bool

Cette propriété contient une valeur indiquant si le capteur est occupé.

Certains capteurs peuvent être présents sur le système mais ne pas pouvoir être utilisés. Cette fonction renvoie la valeur true si le capteur est occupé. Vous ne pourrez pas utiliser le capteur à l'adresse start().

Notez que cette fonction ne renvoie pas la valeur true si vous utilisez le capteur, mais seulement si un autre processus utilise le capteur.

Fonctions d'accès :

Signal de notification :

Voir également busyChanged().

[read-only] connectedToBackend : bool

Cette propriété contient une valeur indiquant si le capteur s'est connecté à un backend.

Un capteur qui n'a pas été connecté à un backend ne peut rien faire d'utile.

Appelez la méthode connectToBackend() pour forcer le capteur à se connecter immédiatement à un backend. Cette méthode est automatiquement appelée si vous appelez start(). Vous ne devez donc le faire que si vous avez besoin d'accéder aux propriétés du capteur (par exemple, pour interroger les métadonnées du capteur avant de l'utiliser).

Fonctions d'accès :

[read-only] currentOrientation : int

Cette propriété indique l'orientation actuelle utilisée pour la rotation des valeurs de lecture.

Cette orientation peut être différente de l'orientation de l'écran. Par exemple, dans le mode FixedOrientation, les valeurs lues ne sont pas tournées, et cette propriété vaut donc 0.

Dans le mode UserOrientation, les lectures sont pivotées en fonction de la propriété userOrientation, et cette propriété est donc égale à la propriété userOrientation.

Dans le mode AutomaticOrientation, les lectures sont pivotées en fonction de l'orientation de l'écran, et cette propriété sera donc égale à l'orientation actuelle de l'écran.

Cette propriété est définie par le backend et n'est valable que pour les capteurs orientables.

Fonctions d'accès :

Signal de notification :

dataRate : int

Cette propriété indique le débit de données auquel le capteur doit fonctionner.

Elle est mesurée en Hertz.

Le débit de données est la fréquence maximale à laquelle le capteur peut détecter des changements.

La définition de cette propriété n'est pas portable et peut entraîner des conflits avec d'autres applications. Consultez le backend du capteur et la documentation de la plateforme pour connaître la politique concernant les applications multiples qui demandent un débit de données.

La valeur par défaut (0) signifie que l'application ne se préoccupe pas du débit de données. Les applications doivent envisager d'utiliser une interrogation de la valeur actuelle basée sur un minuteur ou s'assurer que le code qui traite les valeurs peut s'exécuter très rapidement car la plateforme peut fournir des mises à jour des centaines de fois par seconde.

Cette valeur doit être définie avant d'appeler start() car le capteur peut ne pas remarquer les changements de cette valeur pendant qu'il est en cours d'exécution.

Notez qu'il n'existe aucun mécanisme permettant de déterminer le débit de données actuellement utilisé par la plate-forme.

Fonctions d'accès :

Signal Notificateur :

Voir aussi QSensor::availableDataRates.

[read-only] description : QString

Cette propriété contient une chaîne descriptive pour le capteur.

Fonctions d'accès :

[read-only] efficientBufferSize : int

Cette propriété contient la taille de tampon la plus efficace. Normalement, elle vaut 1 (ce qui signifie qu'aucune taille particulière n'est la plus efficace). Certains pilotes de capteurs disposent d'une mémoire tampon FIFO, ce qui rend plus efficace la transmission en une seule fois d'une quantité de données équivalente à la taille de la mémoire FIFO.

Fonctions d'accès :

Signal de notification :

Voir également QSensor::bufferSize et QSensor::maxBufferSize.

[read-only] error : int

Cette propriété contient le dernier code d'erreur défini sur le capteur.

Il est à noter que les codes d'erreur sont spécifiques à chaque capteur.

Fonctions d'accès :

Signal de notification :

identifier : QByteArray

Cette propriété contient l'identifiant du backend pour le capteur.

Notez que l'identifiant est rempli automatiquement lorsque le capteur est connecté à un backend. Si vous souhaitez connecter un backend spécifique, vous devez appeler setIdentifier() avant connectToBackend().

Fonctions d'accès :

Notifier signal :

[read-only] maxBufferSize : int

Cette propriété contient la taille maximale de la mémoire tampon.

Notez qu'elle peut être égale à 1, auquel cas le capteur ne prend en charge aucune forme de mise en mémoire tampon. Dans ce cas, isFeatureSupported(QSensor::Buffering) renverra également false.

Fonctions d'accès :

Signal du notificateur :

Voir également QSensor::bufferSize et QSensor::efficientBufferSize.

outputRange : int

Cette propriété contient la plage de sortie utilisée par le capteur.

Cette valeur représente l'index de la liste QSensor::outputRanges à utiliser.

La définition de cette propriété n'est pas portable et peut entraîner des conflits avec d'autres applications. Consultez le backend du capteur et la documentation de la plateforme pour connaître la politique concernant les applications multiples qui demandent une plage de sortie.

La valeur par défaut (-1) signifie que l'application ne se préoccupe pas de la plage de sortie.

Notez qu'il n'existe aucun mécanisme permettant de déterminer la plage de sortie actuellement utilisée par la plateforme.

Fonctions d'accès :

Voir aussi QSensor::outputRanges.

[read-only] outputRanges : qoutputrangelist

Cette propriété contient une liste des plages de sortie prises en charge par le capteur.

Un capteur peut avoir plus d'une plage de sortie. Généralement, cela permet d'obtenir une plus grande plage de mesure au prix d'une baisse de la précision.

Notez que cette information n'est pas obligatoire. Elle n'est généralement disponible que pour les capteurs dont les plages de sortie sont sélectionnables (comme les accéléromètres classiques).

Fonctions d'accès :

Voir également QSensor::outputRange et qoutputrangelist.

[read-only] reading : QSensorReading*

Cette propriété contient la classe de lecture.

La classe de lecture permet d'accéder aux relevés des capteurs. L'objet lecture est un cache volatile de la lecture la plus récente du capteur qui a été reçue, de sorte que l'application doit traiter les lectures immédiatement ou enregistrer les valeurs quelque part pour un traitement ultérieur.

Notez que cet objet renvoie 0 tant qu'un backend de capteur n'est pas connecté à un backend.

Notez également que les relevés ne sont pas immédiatement disponibles après l'appel de start(). Les applications doivent attendre que le signal readingChanged() soit émis.

Fonctions d'accès :

Signal Notifier :

Voir également isConnectedToBackend() et start().

skipDuplicates : bool

Indique si les valeurs de lecture en double doivent être omises.

Lorsque le saut des doublons est activé, les relevés successifs présentant des valeurs identiques ou très similaires sont omis. Cela permet de réduire la quantité de traitement effectué, car moins de relevés de capteurs sont disponibles. Par conséquent, les relevés arrivent à un intervalle irrégulier.

Le saut de doublons n'est pas seulement activé pour les relevés qui sont exactement les mêmes, mais aussi pour les relevés qui sont assez similaires, car chaque capteur a un peu d'instabilité, même si l'appareil n'est pas déplacé.

La prise en charge de cette propriété dépend du backend. Utilisez isFeatureSupported() pour vérifier si elle est prise en charge par la plateforme actuelle.

Le saut de doublon est désactivé par défaut.

Le saut de duplicata prend effet lorsque le capteur est démarré, la modification de la propriété pendant que le capteur est actif n'a pas d'effet immédiat.

Fonctions d'accès :

Signal de notification :

[read-only] type : const QByteArray

Cette propriété contient le type de capteur.

Fonctions d'accès :

userOrientation : int

Cette propriété contient l'angle utilisé pour la rotation des valeurs de lecture dans le mode UserOrientation.

Lorsque la propriété axesOrientationMode est définie sur UserOrientation, l'angle de rotation des valeurs de lecture est tiré de cette propriété. Dans les autres modes, cette propriété n'a aucun effet.

La valeur par défaut est 0. Les seules valeurs valables sont 0, 90, 180 et 270, car ce sont les seules orientations possibles de l'écran.

Cette propriété n'est valable que pour les capteurs orientables.

Fonctions d'accès :

Signal Notificateur :

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;