Qt 5.13 | Qt Bluetooth | QBluetooth Namespace

Qt 5.13.2 Reference Documentation

# QBluetooth Namespace

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

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

This namespace was introduced in Qt 5.2.

## Types

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

## Detailed Description

## Type Documentation

### enum QBluetooth::AttAccessConstraint
flags QBluetooth::AttAccessConstraints

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

Constant | Value | Description
--- | --- | ---
`QBluetooth::AttAuthorizationRequired` | `0x1` | The client needs authorization from the ATT server to access the attribute.
`QBluetooth::AttAuthenticationRequired` | `0x2` | The client needs to be authenticated to access the attribute.
`QBluetooth::AttEncryptionRequired` | `0x4` | The 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.

### typedef QLowEnergyHandle

Typedef for Bluetooth Low Energy ATT attribute handles.

This typedef was introduced in Qt 5.4.

### enum QBluetooth::Security
flags QBluetooth::SecurityFlags

This enum describe the security requirements of a Bluetooth service.

Constant | Value | Description
--- | --- | ---
`QBluetooth::NoSecurity` | `0x00` | The service does not require any security.
`QBluetooth::Authorization` | `0x01` | The service requires authorization by the user, unless the device is Authorized-Paired.
`QBluetooth::Authentication` | `0x02` | The service requires authentication. Device must be paired, and the user is prompted on connection unless the device is Authorized-Paired.
`QBluetooth::Encryption` | `0x04` | The service requires the communication link to be encrypted. This requires the device to be paired.
`QBluetooth::Secure` | `0x08` | The 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.