QBluetoothDeviceInfo Class

The QBluetoothDeviceInfo class stores information about the Bluetooth device. More...

Header: #include <QBluetoothDeviceInfo>
qmake: QT += bluetooth

Public Types

enum CoreConfiguration { UnknownCoreConfiguration, BaseRateCoreConfiguration, BaseRateAndLowEnergyCoreConfiguration, LowEnergyCoreConfiguration }
flags CoreConfigurations
enum class Field { None, RSSI, ManufacturerData, ServiceData, All }
flags Fields
enum MajorDeviceClass { MiscellaneousDevice, ComputerDevice, PhoneDevice, NetworkDevice, AudioVideoDevice, …, UncategorizedDevice }
enum MinorAudioVideoClass { UncategorizedAudioVideoDevice, WearableHeadsetDevice, HandsFreeDevice, Microphone, Loudspeaker, …, GamingDevice }
enum MinorComputerClass { UncategorizedComputer, DesktopComputer, ServerComputer, LaptopComputer, HandheldClamShellComputer, …, WearableComputer }
enum MinorHealthClass { UncategorizedHealthDevice, HealthBloodPressureMonitor, HealthThermometer, HealthWeightScale, HealthGlucoseMeter, …, HealthStepCounter }
enum MinorImagingClass { UncategorizedImagingDevice, ImageDisplay, ImageCamera, ImageScanner, ImagePrinter }
enum MinorMiscellaneousClass { UncategorizedMiscellaneous }
enum MinorNetworkClass { NetworkFullService, NetworkLoadFactorOne, NetworkLoadFactorTwo, NetworkLoadFactorThree, NetworkLoadFactorFour, …, NetworkNoService }
enum MinorPeripheralClass { UncategorizedPeripheral, KeyboardPeripheral, PointingDevicePeripheral, KeyboardWithPointingDevicePeripheral, JoystickPeripheral, …, CardReaderPeripheral }
enum MinorPhoneClass { UncategorizedPhone, CellularPhone, CordlessPhone, SmartPhone, WiredModemOrVoiceGatewayPhone, CommonIsdnAccessPhone }
enum MinorToyClass { UncategorizedToy, ToyRobot, ToyVehicle, ToyDoll, ToyController, ToyGame }
enum MinorWearableClass { UncategorizedWearableDevice, WearableWristWatch, WearablePager, WearableJacket, WearableHelmet, WearableGlasses }
enum ServiceClass { NoService, PositioningService, NetworkingService, RenderingService, CapturingService, …, AllServices }
flags ServiceClasses

Public Functions

QBluetoothDeviceInfo()
QBluetoothDeviceInfo(const QBluetoothAddress &address, const QString &name, quint32 classOfDevice)
QBluetoothDeviceInfo(const QBluetoothUuid &uuid, const QString &name, quint32 classOfDevice)
QBluetoothDeviceInfo(const QBluetoothDeviceInfo &other)
~QBluetoothDeviceInfo()
QBluetoothAddress address() const
QBluetoothDeviceInfo::CoreConfigurations coreConfigurations() const
QBluetoothUuid deviceUuid() const
bool isCached() const
bool isValid() const
QBluetoothDeviceInfo::MajorDeviceClass majorDeviceClass() const
QMultiHash<quint16, QByteArray> manufacturerData() const
QByteArray manufacturerData(quint16 manufacturerId) const
QList<quint16> manufacturerIds() const
quint8 minorDeviceClass() const
QString name() const
qint16 rssi() const
QBluetoothDeviceInfo::ServiceClasses serviceClasses() const
(since 6.3) QMultiHash<QBluetoothUuid, QByteArray> serviceData() const
(since 6.3) QByteArray serviceData(const QBluetoothUuid &serviceId) const
(since 6.3) QList<QBluetoothUuid> serviceIds() const
(since 6.0) QList<QBluetoothUuid> serviceUuids() const
void setCached(bool cached)
void setCoreConfigurations(QBluetoothDeviceInfo::CoreConfigurations coreConfigs)
void setDeviceUuid(const QBluetoothUuid &uuid)
bool setManufacturerData(quint16 manufacturerId, const QByteArray &data)
(since 6.2) void setName(const QString &name)
void setRssi(qint16 signal)
(since 6.3) bool setServiceData(const QBluetoothUuid &serviceId, const QByteArray &data)
void setServiceUuids(const QList<QBluetoothUuid> &uuids)
QBluetoothDeviceInfo &operator=(const QBluetoothDeviceInfo &other)
bool operator!=(const QBluetoothDeviceInfo &a, const QBluetoothDeviceInfo &b)
bool operator==(const QBluetoothDeviceInfo &a, const QBluetoothDeviceInfo &b)

Detailed Description

QBluetoothDeviceInfo provides information about a Bluetooth device's name, address and class of device.

Member Type Documentation

enum QBluetoothDeviceInfo::CoreConfiguration
flags QBluetoothDeviceInfo::CoreConfigurations

This enum describes the configuration of the device.

ConstantValueDescription
QBluetoothDeviceInfo::UnknownCoreConfiguration0x0The type of the Bluetooth device cannot be determined.
QBluetoothDeviceInfo::BaseRateCoreConfiguration0x02The device is a standard Bluetooth device.
QBluetoothDeviceInfo::BaseRateAndLowEnergyCoreConfiguration0x03The device is a Bluetooth Smart device with support for standard and Low Energy device.
QBluetoothDeviceInfo::LowEnergyCoreConfiguration0x01The device is a Bluetooth Low Energy device.

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

enum class QBluetoothDeviceInfo::Field
flags QBluetoothDeviceInfo::Fields

This enum is used in conjuntion with the QBluetoothDeviceDiscoveryAgent::deviceUpdated() signal and indicates the field that changed.

ConstantValueDescription
QBluetoothDeviceInfo::Field::None0x0000None of the values changed.
QBluetoothDeviceInfo::Field::RSSI0x0001The rssi() value of the device changed.
QBluetoothDeviceInfo::Field::ManufacturerData0x0002The manufacturerData() field changed
QBluetoothDeviceInfo::Field::ServiceData0x0004The serviceData() field changed
QBluetoothDeviceInfo::Field::All0x7fffMatches every possible field.

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

enum QBluetoothDeviceInfo::MajorDeviceClass

This enum describes a Bluetooth device's major device class.

ConstantValueDescription
QBluetoothDeviceInfo::MiscellaneousDevice0A miscellaneous device.
QBluetoothDeviceInfo::ComputerDevice1A computer device or PDA.
QBluetoothDeviceInfo::PhoneDevice2A telephone device.
QBluetoothDeviceInfo::NetworkDevice3A device that provides access to a local area network (since Qt 5.13).
QBluetoothDeviceInfo::AudioVideoDevice4A device capable of playback or capture of audio and/or video.
QBluetoothDeviceInfo::PeripheralDevice5A peripheral device such as a keyboard, mouse, and so on.
QBluetoothDeviceInfo::ImagingDevice6An imaging device such as a display, printer, scanner or camera.
QBluetoothDeviceInfo::WearableDevice7A wearable device such as a watch or pager.
QBluetoothDeviceInfo::ToyDevice8A toy.
QBluetoothDeviceInfo::HealthDevice9A health reated device such as heart rate or temperature monitor.
QBluetoothDeviceInfo::UncategorizedDevice31A device that does not fit into any of the other device classes.

enum QBluetoothDeviceInfo::MinorAudioVideoClass

This enum describes the minor device classes for audio/video devices.

ConstantValueDescription
QBluetoothDeviceInfo::UncategorizedAudioVideoDevice0An uncategorized audio/video device.
QBluetoothDeviceInfo::WearableHeadsetDevice1A wearable headset device.
QBluetoothDeviceInfo::HandsFreeDevice2A handsfree device.
QBluetoothDeviceInfo::Microphone4A microphone.
QBluetoothDeviceInfo::Loudspeaker5A loudspeaker.
QBluetoothDeviceInfo::Headphones6Headphones.
QBluetoothDeviceInfo::PortableAudioDevice7A portable audio device.
QBluetoothDeviceInfo::CarAudio8A car audio device.
QBluetoothDeviceInfo::SetTopBox9A settop box.
QBluetoothDeviceInfo::HiFiAudioDevice10A HiFi audio device.
QBluetoothDeviceInfo::Vcr11A video cassette recorder.
QBluetoothDeviceInfo::VideoCamera12A video camera.
QBluetoothDeviceInfo::Camcorder13A video camera.
QBluetoothDeviceInfo::VideoMonitor14A video monitor.
QBluetoothDeviceInfo::VideoDisplayAndLoudspeaker15A video display with built-in loudspeaker.
QBluetoothDeviceInfo::VideoConferencing16A video conferencing device.
QBluetoothDeviceInfo::GamingDevice18A gaming device.

enum QBluetoothDeviceInfo::MinorComputerClass

This enum describes the minor device classes for computer devices.

ConstantValueDescription
QBluetoothDeviceInfo::UncategorizedComputer0An uncategorized computer device.
QBluetoothDeviceInfo::DesktopComputer1A desktop computer.
QBluetoothDeviceInfo::ServerComputer2A server computer.
QBluetoothDeviceInfo::LaptopComputer3A laptop computer.
QBluetoothDeviceInfo::HandheldClamShellComputer4A clamshell handheld computer or PDA.
QBluetoothDeviceInfo::HandheldComputer5A handheld computer or PDA.
QBluetoothDeviceInfo::WearableComputer6A wearable computer.

enum QBluetoothDeviceInfo::MinorHealthClass

This enum describes the minor device classes for health devices.

ConstantValueDescription
QBluetoothDeviceInfo::UncategorizedHealthDevice0An uncategorized health device.
QBluetoothDeviceInfo::HealthBloodPressureMonitor0x1A blood pressure monitor.
QBluetoothDeviceInfo::HealthThermometer0x2A Thermometer.
QBluetoothDeviceInfo::HealthWeightScale0x3A scale.
QBluetoothDeviceInfo::HealthGlucoseMeter0x4A glucose meter.
QBluetoothDeviceInfo::HealthPulseOximeter0x5A blood oxygen saturation meter.
QBluetoothDeviceInfo::HealthDataDisplay0x7A data display.
QBluetoothDeviceInfo::HealthStepCounter0x8A pedometer.

enum QBluetoothDeviceInfo::MinorImagingClass

This enum describes the minor device classes for imaging devices.

ConstantValueDescription
QBluetoothDeviceInfo::UncategorizedImagingDevice0An uncategorized imaging device.
QBluetoothDeviceInfo::ImageDisplay0x04A device capable of displaying images.
QBluetoothDeviceInfo::ImageCamera0x08A camera.
QBluetoothDeviceInfo::ImageScanner0x10An image scanner.
QBluetoothDeviceInfo::ImagePrinter0x20A printer.

enum QBluetoothDeviceInfo::MinorMiscellaneousClass

This enum describes the minor device classes for miscellaneous Bluetooth devices.

ConstantValueDescription
QBluetoothDeviceInfo::UncategorizedMiscellaneous0An uncategorized miscellaneous device.

enum QBluetoothDeviceInfo::MinorNetworkClass

This enum describes the minor device classes for local area network access devices. Local area network access devices use the minor device class to specify the current network utilization.

ConstantValueDescription
QBluetoothDeviceInfo::NetworkFullService0x00100% of the total bandwidth is available.
QBluetoothDeviceInfo::NetworkLoadFactorOne0x080 - 17% of the total bandwidth is currently being used.
QBluetoothDeviceInfo::NetworkLoadFactorTwo0x1017 - 33% of the total bandwidth is currently being used.
QBluetoothDeviceInfo::NetworkLoadFactorThree0x1833 - 50% of the total bandwidth is currently being used.
QBluetoothDeviceInfo::NetworkLoadFactorFour0x2050 - 67% of the total bandwidth is currently being used.
QBluetoothDeviceInfo::NetworkLoadFactorFive0x2867 - 83% of the total bandwidth is currently being used.
QBluetoothDeviceInfo::NetworkLoadFactorSix0x3083 - 99% of the total bandwidth is currently being used.
QBluetoothDeviceInfo::NetworkNoService0x38No network service available.

enum QBluetoothDeviceInfo::MinorPeripheralClass

This enum describes the minor device classes for peripheral devices.

ConstantValueDescription
QBluetoothDeviceInfo::UncategorizedPeripheral0An uncategorized peripheral device.
QBluetoothDeviceInfo::KeyboardPeripheral0x10A keyboard.
QBluetoothDeviceInfo::PointingDevicePeripheral0x20A pointing device, for example a mouse.
QBluetoothDeviceInfo::KeyboardWithPointingDevicePeripheral0x30A keyboard with built-in pointing device.
QBluetoothDeviceInfo::JoystickPeripheral0x01A joystick.
QBluetoothDeviceInfo::GamepadPeripheral0x02A game pad.
QBluetoothDeviceInfo::RemoteControlPeripheral0x03A remote control.
QBluetoothDeviceIn