QAccelerometer Class
QAccelerometer 클래스는 QSensor 를 감싸는 편의 래퍼입니다. 더 보기...
| 헤더: | #include <QAccelerometer> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Sensors) target_link_libraries(mytarget PRIVATE Qt6::Sensors) |
| qmake: | QT += sensors |
| 상속: | QSensor |
공개 유형
| enum | AccelerationMode { Combined, Gravity, User } |
속성
- accelerationMode : AccelerationMode
공개 함수
| QAccelerometer(QObject *parent = nullptr) | |
| virtual | ~QAccelerometer() |
| QAccelerometer::AccelerationMode | accelerationMode() const |
| QAccelerometerReading * | reading() const |
| void | setAccelerationMode(QAccelerometer::AccelerationMode accelerationMode) |
신호
| void | accelerationModeChanged(QAccelerometer::AccelerationMode accelerationMode) |
상세 설명
유일한 동작상의 차이점은 이 클래스가 유형을 올바르게 설정한다는 점입니다.
또한 가속도계 값에 중력이 포함될지 여부를 제어하는 가속도 모드 변경도 지원합니다.
또한, 이 클래스는 QSensorReading 대신 QAccelerometerReading 를 반환하는 reading() 함수를 제공합니다.
센서의 작동 방식에 대한 자세한 내용은 QAccelerometerReading 을 참조하십시오.
QAccelerometerReading도 참조하십시오 .
멤버 유형 설명서
enum QAccelerometer::AccelerationMode
이 열거형은 가속도 센서의 가속도 모드를 나타냅니다.
가속도 모드는 센서가 가속도를 보고하는 방식을 제어합니다. QAccelerometer::Combined는 값을 물리적으로 직접 측정할 수 있는 유일한 모드이며, 그 외의 모드는 근사값입니다.
| 상수 | 값 | 설명 |
|---|---|---|
QAccelerometer::Combined | 0 | 중력에 의한 가속도와 사용자가 기기를 움직여 발생하는 가속도가 합쳐진 형태로 보고됩니다. |
QAccelerometer::Gravity | 1 | 중력에 의한 가속도만 보고됩니다. 사용자가 기기를 움직여 발생하는 움직임은 기기가 회전할 때 방향이 바뀌는 것 외에는 아무런 영향을 미치지 않습니다. |
QAccelerometer::User | 2 | 사용자가 기기를 움직여 발생하는 가속도만 보고되며, 중력의 영향은 상쇄됩니다. 따라서 정지 상태의 기기는 0 또는 0에 가까운 값을 보고해야 합니다. 다른 API에서는 이 모드를 선형 가속도라고 부를 수도 있습니다. |
QAccelerometer::accelerationMode도 참조하십시오 .
속성 설명서
accelerationMode : AccelerationMode
이 속성은 가속도 모드가 가속도 값이 보고되는 방식을 제어합니다.
가속도 모드는 가속도 센서가 값을 보고하는 방식을 제어합니다. 기본 모드는 ' QAccelerometer::Combined'이며, 이는 중력에 의한 가속도가 보고된 값에 포함됨을 의미합니다.
일반 상대성 이론에 따르면, 중력에 의한 가속도와 사용자가 기기를 움직여 발생하는 가속도를 물리적으로 구별하는 것은 불가능합니다. 대부분의 기기는 센서 퓨전(sensor fusion)을 사용하여 가속도의 어느 부분이 중력에 의한 것인지 파악합니다. 예를 들어, 회전 센서를 사용하여 중력 방향을 계산하고 중력의 크기가 일정하다고 가정하는 방식이죠. 따라서 결과는 단지 근사치에 불과하며 부정확할 수 있습니다. 중력을 근사화하지 않는 ‘ QAccelerometer::Combined ’ 모드가 가장 정확합니다.
모든 백엔드와 기기가 가속도 모드 설정을 지원하는 것은 아닙니다. 이러한 경우에는 기본 모드인 ‘ QAccelerometer::Combined ’가 사용되며, 이를 변경해도 아무런 효과가 없습니다.
액세스 함수:
| QAccelerometer::AccelerationMode | accelerationMode() const |
| void | setAccelerationMode(QAccelerometer::AccelerationMode accelerationMode) |
알림 신호:
| void | accelerationModeChanged(QAccelerometer::AccelerationMode accelerationMode) |
멤버 함수 문서
[explicit] QAccelerometer::QAccelerometer(QObject *parent = nullptr)
parent 의 자식 요소로 센서를 생성합니다.
[virtual noexcept] QAccelerometer::~QAccelerometer()
센서를 파괴합니다. 센서가 아직 중지되지 않은 경우 이를 중지시킵니다.
[signal] void QAccelerometer::accelerationModeChanged(QAccelerometer::AccelerationMode accelerationMode)
accelerationMode 가 변경되었을 때 발생합니다.
참고: 속성 accelerationMode 에 대한알림 신호입니다.
QAccelerometerReading *QAccelerometer::reading() const
이 센서의 판독 클래스를 반환합니다.
QSensor::reading()도 참조하십시오 .
void QAccelerometer::setAccelerationMode(QAccelerometer::AccelerationMode accelerationMode)
가속도 모드를 ‘ accelerationMode ’로 설정합니다.
참고: accelerationMode 속성에 대한설정 함수입니다.
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.
