호환성 지도
| 색상 | 설명 |
| 센서가 지원됩니다. | |
| 이 센서는 지원되지 않습니다. |
| 기능 | Android | Linux | iOS | Windows | 일반 |
| 가속도계 | |||||
| 주변 광 센서 | |||||
| 주변 온도 센서 | |||||
| 나침반 | |||||
| 자이로스코프 | |||||
| 광 센서 | |||||
| 자력계 | |||||
| 방향 센서 | |||||
| 압력 센서 | |||||
| 근접 센서 | |||||
| 회전 센서 | |||||
| 기울기 센서 |
위의 표 외에도 각 센서 유형마다 특정 기능을 지원할 수 있습니다. 예를 들어, 자력계는 지리적 값을 반환하는 기능을 지원할 수 있습니다. 자세한 내용은 QSensor::isFeatureSupported()을 참조하십시오.
플랫폼별 참고 사항
Windows
Windows 백엔드는 MSVC로 빌드된 Qt 설치 환경에서 지원됩니다.
Android
Android 백엔드에서 제공하는 센서는 별도의 Android 권한을 요청하지 않고도 읽을 수 있습니다.
유일한 제한 사항은 가속도계, 자이로스코프 및 자력계의 샘플링 속도와 관련이 있습니다. Android 12(API 레벨 31)부터는 200 Hz보다 높은 속도로 이러한 센서 값을 읽으려면 ` android.permission.HIGH_SAMPLING_RATE_SENSORS ` 권한이 필요합니다. 이는 설치 시 사용자에게 확인 메시지 없이 자동으로 부여되는 일반 권한입니다. 해당 권한을 선언하지 않으면 샘플링 속도는 200 Hz로 제한됩니다.
qt_add_android_permission을 사용하여 애플리케이션에 권한을 선언하십시오:
qt_add_android_permission(myapp
NAME android.permission.HIGH_SAMPLING_RATE_SENSORS
)참고: 직접 작성한 AndroidManifest.xml을 사용하는경우 , 권한이 추가되려면 해당 파일에 <!-- %%INSERT_PERMISSIONS --> 태그가 포함되어야 합니다. Qt 권한 및 기능을 참조하십시오.
HarmonyOS
HarmonyOS의 일부 센서는 데이터를 읽기 전에 권한이 필요합니다:
- QAccelerometer
ohos.permission.ACCELEROMETER이 필요합니다. - QGyroscope
ohos.permission.GYROSCOPE이 필요합니다.
HarmonyOS 백엔드에서 제공하는 다른 센서(조도 센서, 자력계, 회전 센서)는 별도의 권한 없이도 데이터를 읽을 수 있습니다.
권한이 부여되지 않은 센서에 대한 구독은 실패하며, 측정값이 전달되지 않습니다.
qt_add_harmonyos_permission 을 사용하여 애플리케이션에 대한 권한을 선언하십시오:
qt_add_harmonyos_permission(myapp
NAME ohos.permission.ACCELEROMETER
)© 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.