QBluetooth Namespace

The QBluetooth namespace provides classes and functions related to Bluetooth. More...

Header: #include <QBluetooth>
qmake: QT += bluetooth
Since: Qt 5.2

Types

enum class AttAccessConstraint { AttAuthorizationRequired, AttAuthenticationRequired, AttEncryptionRequired }
flags AttAccessConstraints
QLowEnergyHandle
enum class Security { NoSecurity, Authorization, Authentication, Encryption, Secure }
flags SecurityFlags

Detailed Description

Type Documentation

[since 5.7] enum class QBluetooth::AttAccessConstraint
flags QBluetooth::AttAccessConstraints

This enum describes the possible requirements for reading or writing an ATT attribute.

ConstantValueDescription
QBluetooth::AttAccessConstraint::AttAuthorizationRequired0x1The client needs authorization from the ATT server to access the attribute.
QBluetooth::AttAccessConstraint::AttAuthenticationRequired0x2The client needs to be authenticated to access the attribute.
QBluetooth::AttAccessConstraint::AttEncryptionRequired0x4The attribute can only be accessed if the connection is encrypted.

This enum was introduced or modified in Qt 5.7.

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

[since 5.4] QLowEnergyHandle

Typedef for Bluetooth Low Energy ATT attribute handles.

This typedef was introduced in Qt 5.4.

enum class QBluetooth::Security
flags QBluetooth::SecurityFlags

This enum describe the security requirements of a Bluetooth service.

ConstantValueDescription
QBluetooth::Security::NoSecurity0x00The service does not require any security.
QBluetooth::Security::Authorization0x01The service requires authorization by the user, unless the device is Authorized-Paired.
QBluetooth::Security::Authentication0x02The service requires authentication. Device must be paired, and the user is prompted on connection unless the device is Authorized-Paired.
QBluetooth::Security::Encryption0x04The service requires the communication link to be encrypted. This requires the device to be paired.
QBluetooth::Security::Secure0x08The service requires the communication link to be secure. Simple Pairing from Bluetooth 2.1 or greater is required. Legacy pairing is not permitted.

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