QLocationPermission Class
获取用户的地理位置。更多...
| 标题： | #include <QPermissions> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| 自： | Qt 6.5 |
公共类型
| enum | Accuracy { Approximate, Precise } |
| enum | Availability { WhenInUse, Always } |
公共函数
| QLocationPermission::Accuracy | accuracy() const |
| QLocationPermission::Availability | availability() const |
| void | setAccuracy(QLocationPermission::Accuracy accuracy) |
| void | setAvailability(QLocationPermission::Availability availability) |
详细说明
默认情况下，请求的是近似精度，且仅在应用程序正在使用时生效。请使用setAccuracy() 和/或setAvailability() 来覆盖默认设置。
要求
若要在运行时请求此权限，必须在构建时进行以下平台特定的使用声明：
| 平台 | 类型 | |
|---|---|---|
| macOS | 用法说明 | NSLocationUsageDescription |
| iOS | 使用说明 | NSLocationWhenInUseUsageDescription，以及NSLocationAlwaysAndWhenInUseUsageDescription （若请求QLocationPermission::Always |
| Android | uses-permission |
注意： QLocationPermission::Always |
请参阅各个使用声明类型，了解如何将它们添加到您的项目中。
另请参阅 QPermission 、QCoreApplication::requestPermission()、QCoreApplication::checkPermission() 以及“应用程序权限”。
成员类型文档
enum QLocationPermission::Accuracy
此枚举用于控制位置数据的精度。
| 常量 | 值 | 描述 |
|---|---|---|
QLocationPermission::Approximate | 0 | 请求近似位置。 |
QLocationPermission::Precise | 1 | 请求精确位置。 |
enum QLocationPermission::Availability
此枚举用于控制位置数据的可用性。
| 常量 | 值 | 描述 |
|---|---|---|
QLocationPermission::WhenInUse | 0 | 仅当应用程序正在使用时，位置信息才可用。 |
QLocationPermission::Always | 1 | 位置信息始终可用，包括应用程序在后台运行时。 |
成员函数文档
QLocationPermission::Accuracy QLocationPermission::accuracy() const
返回请求的精度。
另请参阅 setAccuracy()。
QLocationPermission::Availability QLocationPermission::availability() const
返回请求的可用性。
另请参阅 setAvailability()。
void QLocationPermission::setAccuracy(QLocationPermission::Accuracy accuracy)
设置请求的预期accuracy 。
另请参阅 accuracy()。
void QLocationPermission::setAvailability(QLocationPermission::Availability availability)
设置请求的期望availability 值。
另请参阅 availability()。
© 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.
