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 |
(从 6.6 起)
enum
|
CommunicationMode { Access, Advertise, Default } |
flags | CommunicationModes |
(从 6.6 起)
QBluetoothPermission::CommunicationModes
|
communicationModes () const |
(从 6.6 起)
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.
该枚举在 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 ().