QAccelerometer Class
La classe `QAccelerometer` est un wrapper pratique autour de ` QSensor`. En savoir plus...
| En-tête : | #include <QAccelerometer> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Sensors) target_link_libraries(mytarget PRIVATE Qt6::Sensors) |
| qmake : | QT += sensors |
| Hérite de : | QSensor |
Types publics
| enum | AccelerationMode { Combined, Gravity, User } |
Propriétés
- accelerationMode : AccelerationMode
Fonctions publiques
| QAccelerometer(QObject *parent = nullptr) | |
| virtual | ~QAccelerometer() |
| QAccelerometer::AccelerationMode | accelerationMode() const |
| QAccelerometerReading * | reading() const |
| void | setAccelerationMode(QAccelerometer::AccelerationMode accelerationMode) |
Signaux
| void | accelerationModeChanged(QAccelerometer::AccelerationMode accelerationMode) |
Description détaillée
La seule différence de comportement réside dans le fait que cette classe définit correctement le type.
Elle prend également en charge la modification du mode d’accélération, qui détermine si la force de gravité est incluse ou non dans les valeurs de l’accéléromètre.
De plus, cette classe dispose d’une fonction reading() qui renvoie un objet de type QAccelerometerReading au lieu d’un objet de type QSensorReading.
Pour plus de détails sur le fonctionnement du capteur, voir QAccelerometerReading.
Voir également QAccelerometerReading.
Documentation sur les types de membres
enum QAccelerometer::AccelerationMode
Cette énumération représente le mode d'accélération d'un capteur d'accélération.
Le mode d'accélération détermine la manière dont le capteur signale l'accélération. QAccelerometer::Combined est le seul mode dans lequel les valeurs peuvent être directement mesurées physiquement ; les autres modes ne fournissent qu'une approximation.
| Constante | Valeur | Description |
|---|---|---|
QAccelerometer::Combined | 0 | L'accélération due à la gravité et celle provoquée par les mouvements de l'utilisateur sur l'appareil sont rapportées ensemble. |
QAccelerometer::Gravity | 1 | Seule l’accélération due à la gravité est transmise. Les mouvements de l’appareil provoqués par l’utilisateur n’ont d’autre effet que de modifier la direction lorsque l’appareil est pivoté. |
QAccelerometer::User | 2 | Seule l'accélération provoquée par les mouvements de l'utilisateur est signalée ; l'effet de la gravité est annulé. Un appareil au repos devrait donc afficher des valeurs égales ou proches de zéro. Dans d'autres API, ce mode peut être appelé « accélération linéaire ». |
Voir également QAccelerometer::accelerationMode.
Documentation sur les propriétés
accelerationMode : AccelerationMode
Cette propriété « mode d'accélération » détermine la manière dont les valeurs d'accélération sont transmises.
Le mode d'accélération détermine la manière dont le capteur d'accélération transmet ses valeurs. Le mode par défaut est « QAccelerometer::Combined », ce qui signifie que l'accélération due à la gravité est incluse dans les valeurs transmises.
L'accélération due à la gravité et celle provoquée par le mouvement de l'appareil par l'utilisateur sont physiquement impossibles à distinguer en raison de la relativité générale. La plupart des appareils ont recours à la fusion de capteurs pour déterminer quelle partie de l’accélération est due à la gravité, par exemple en utilisant un capteur de rotation pour calculer la direction de la gravité et en supposant une intensité fixe pour celle-ci. Le résultat n’est donc qu’une approximation et peut s’avérer imprécis. Le mode « QAccelerometer::Combined » est le plus précis, car il ne nécessite aucune approximation de la gravité.
Tous les backends et appareils ne prennent pas nécessairement en charge le réglage du mode d’accélération. Dans ce cas, le mode par défaut « QAccelerometer::Combined » est utilisé ; toute modification n’aura donc aucun effet.
Fonctions d'accès :
| QAccelerometer::AccelerationMode | accelerationMode() const |
| void | setAccelerationMode(QAccelerometer::AccelerationMode accelerationMode) |
Signal de notification :
| void | accelerationModeChanged(QAccelerometer::AccelerationMode accelerationMode) |
Documentation des fonctions membres
[explicit] QAccelerometer::QAccelerometer(QObject *parent = nullptr)
Créez le capteur en tant qu'enfant de parent.
[virtual noexcept] QAccelerometer::~QAccelerometer()
Détruire le capteur. Arrête le capteur s’il n’est pas déjà arrêté.
[signal] void QAccelerometer::accelerationModeChanged(QAccelerometer::AccelerationMode accelerationMode)
Émis lorsque la propriété accelerationMode a été modifiée.
Remarque : signalde notification pour la propriété « accelerationMode ».
QAccelerometerReading *QAccelerometer::reading() const
Renvoie la classe de lecture associée à ce capteur.
Voir aussi QSensor::reading().
void QAccelerometer::setAccelerationMode(QAccelerometer::AccelerationMode accelerationMode)
Définit le mode d'accélération sur « accelerationMode ».
Remarque : fonctionde définition pour la propriété accelerationMode.
Voir également accelerationMode().
© 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.
