IdentifiantMot de passe
Loading...
Mot de passe oublié ?Je m'inscris ! (gratuit)

QBluetoothPermission Class

Access Bluetooth peripherals.

This class was introduced in Qt 6.5.

Article lu   fois.

L'auteur

Liens sociaux

Viadeo Twitter Facebook Share on Google+   

QBluetoothPermission Class

  • Header: QPermissions

  • Since: Qt 6.5

  • CMake:

    find_package(Qt6 REQUIRED COMPONENTS Core)

    target_link_libraries(mytarget PRIVATE Qt6::Core)

  • qmake: QT += core

  • Group: QBluetoothPermission is part of permissions

Detailed Description

 

Requirements

To request this permission at runtime, the following platform specific usage declarations have to be made at build time:

Platform

Type

 

Apple

Usage description

NSBluetoothAlwaysUsageDescription

Android

uses-permission

Up to Android 11 (API Level < 31):

  • android.permission.BLUETOOTH

  • android.permission.ACCESS_FINE_LOCATION

Starting from Android 12 (API Level >= 31):

  • android.permission.BLUETOOTH_ADVERTISE

  • android.permission.BLUETOOTH_CONNECT

  • android.permission.BLUETOOTH_SCAN

  • android.permission.ACCESS_FINE_LOCATION

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.

See Also

Member Type Documentation

 

[since 6.6] enum QBluetoothPermission::CommunicationMode

flags QBluetoothPermission::CommunicationModes

This enum is used to control the allowed Bluetooth communication modes.

Constant

Value

Description

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 or modified in Qt 6.6.

The CommunicationModes type is a typedef for QFlags<CommunicationMode>. It stores an OR combination of CommunicationMode values.

Member Function Documentation

 

[since 6.6] QBluetoothPermission::CommunicationModes QBluetoothPermission::communicationModes() const

Returns the allowed Bluetooth communication modes.

This function was introduced in Qt 6.6.

See Also

[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 Default mode.

This function was introduced in Qt 6.6.

See Also

See also communicationModes()

Vous avez aimé ce tutoriel ? Alors partagez-le en cliquant sur les boutons suivants : Viadeo Twitter Facebook Share on Google+