Access Bluetooth peripherals. 更多...
头: | #include <QPermissions> |
CMake: |
find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core) |
qmake: | QT += core |
Since: | Qt 6.5 |
enum | CommunicationMode { Access, Advertise, Default } |
flags | CommunicationModes |
QBluetoothPermission::CommunicationModes | communicationModes () const |
void | setCommunicationModes (QBluetoothPermission::CommunicationModes modes ) |
To request this permission at runtime, the following platform specific usage declarations have to be made at build time:
平台 | 类型 | |
---|---|---|
Apple | Usage description |
NSBluetoothAlwaysUsageDescription
|
Android |
uses-permission
|
Up to Android 11 (API Level < 31):
Starting from Android 12 (API Level >= 31):
|
Please see the individual usage declaration types for how to add them to your project.
注意:
Currently on Android the
android.permission.ACCESS_FINE_LOCATION
permission is requested together with Bluetooth permissions. This is required for Bluetooth to work properly, unless the application provides a strong assertion in the application manifest that it does not use Bluetooth to derive a physical location. This permission coupling may change in future.
另请参阅 QPermission , QCoreApplication::requestPermission (), QCoreApplication::checkPermission (),和 应用程序权限 .
[since 6.6]
enum QBluetoothPermission::
CommunicationMode
This enum is used to control the allowed Bluetooth communication modes.
常量 | 值 | 描述 |
---|---|---|
QBluetoothPermission::Access
|
0x01
|
Allow this device to access other Bluetooth devices. This includes scanning for nearby devices and connecting to them. |
QBluetoothPermission::Advertise
|
0x02
|
Allow other Bluetooth devices to discover this device. |
QBluetoothPermission::Default
|
Access | Advertise
|
This configuration is used by default. |
注意: The fine-grained permissions are currently supported only on Android 12 and newer. On older Android versions, as well as on Apple operating systems, any mode results in full Bluetooth access.
注意:
For now the
Access
mode on Android also requests the
precise location
permission. This permission coupling may change in the future.
This enum was introduced in Qt 6.6.
The CommunicationModes type is a typedef for QFlags <CommunicationMode>. It stores an OR combination of CommunicationMode values.
[since 6.6]
QBluetoothPermission::CommunicationModes
QBluetoothPermission::
communicationModes
() const
Returns the allowed Bluetooth communication modes.
该函数在 Qt 6.6 引入。
另请参阅 setCommunicationModes ().
[since 6.6]
void
QBluetoothPermission::
setCommunicationModes
(
QBluetoothPermission::CommunicationModes
modes
)
Sets the allowed Bluetooth communication modes to modes .
注意:
A default-constructed instance of
CommunicationModes
has no sense, so an attempt to set such a mode will raise a
qWarning()
and fall back to using the
默认
模式。
该函数在 Qt 6.6 引入。
另请参阅 communicationModes ().