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
이 열거형은 가속도 센서의 가속도 모드를 나타냅니다.
가속 모드는 센서가 가속도를 보고하는 방식을 제어합니다. 가속도계::결합은 값을 직접 물리적으로 측정할 수 있는 유일한 모드이며, 다른 모드는 근사치입니다.
| Constant | 값 | 설명 |
|---|---|---|
QAccelerometer::Combined | 0 | 중력에 의한 가속도와 사용자가 디바이스를 움직여 발생하는 가속도가 모두 합산되어 보고됩니다. |
QAccelerometer::Gravity | 1 | 중력에 의한 가속도만 보고됩니다. 사용자에 의한 기기의 움직임은 기기가 회전할 때 방향을 바꾸는 것 외에는 영향을 미치지 않습니다. |
QAccelerometer::User | 2 | 사용자가 디바이스를 움직일 때 발생하는 가속도만 보고되며 중력의 영향은 상쇄됩니다. 따라서 정지 상태의 디바이스는 0에 가깝거나 0에 가까운 값을 보고해야 합니다. 다른 API에서는 이 모드를 선형 가속도라고 할 수 있습니다. |
QAccelerometer::accelerationMode 를참조하세요 .
속성 문서
accelerationMode : AccelerationMode
이 속성은 가속 모드가 가속도 값을 보고하는 방식을 제어합니다.
가속도 모드는 가속도 센서가 값을 보고하는 방식을 제어합니다. 기본 모드는 QAccelerometer::Combined 으로, 중력에 의한 가속도가 보고된 값에 포함됩니다.
중력에 의한 가속도와 사용자가 디바이스를 움직여 발생하는 가속도는 일반 상대성 이론으로 인해 물리적으로 구분이 불가능합니다. 대부분의 디바이스는 회전 센서를 사용하여 중력 방향을 계산하고 중력에 대해 고정된 크기를 가정하는 등 센서 융합을 통해 가속도의 어느 부분이 중력에 의한 것인지 파악합니다. 따라서 결과는 근사치일 뿐이며 부정확할 수 있습니다. 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()도 참조하세요 .
© 2025 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.
