Spec-Zone.ru › Qt 5.6

Класс QBluetoothDeviceInfo

Класс QBluetoothDeviceInfo хранит информацию о Bluetooth-устройстве. Подробнее...

Заголовок: #include <QBluetoothDeviceInfo>
qmake: QT += bluetooth
С версии: Qt 5.2
  • Список всех членов, включая унаследованные

Типы публичного доступа

перечисление CoreConfiguration { UnknownCoreConfiguration, BaseRateCoreConfiguration, BaseRateAndLowEnergyCoreConfiguration, LowEnergyCoreConfiguration }
флаги CoreConfigurations
перечисление DataCompleteness { DataComplete, DataIncomplete, DataUnavailable }
перечисление MajorDeviceClass { MiscellaneousDevice, ComputerDevice, PhoneDevice, LANAccessDevice, ..., UncategorizedDevice }
перечисление MinorAudioVideoClass { UncategorizedAudioVideoDevice, WearableHeadsetDevice, HandsFreeDevice, Microphone, ..., GamingDevice }
перечисление MinorComputerClass { UncategorizedComputer, DesktopComputer, ServerComputer, LaptopComputer, ..., WearableComputer }
перечисление MinorHealthClass { UncategorizedHealthDevice, HealthBloodPressureMonitor, HealthThermometer, HealthWeightScale, ..., HealthStepCounter }
перечисление MinorImagingClass { UncategorizedImagingDevice, ImageDisplay, ImageCamera, ImageScanner, ImagePrinter }
перечисление MinorMiscellaneousClass { UncategorizedMiscellaneous }
перечисление MinorNetworkClass { NetworkFullService, NetworkLoadFactorOne, NetworkLoadFactorTwo, NetworkLoadFactorThree, ..., NetworkNoService }
перечисление MinorPeripheralClass { UncategorizedPeripheral, KeyboardPeripheral, PointingDevicePeripheral, KeyboardWithPointingDevicePeripheral, ..., CardReaderPeripheral }
перечисление MinorPhoneClass { UncategorizedPhone, CellularPhone, CordlessPhone, SmartPhone, WiredModemOrVoiceGatewayPhone, CommonIsdnAccessPhone }
перечисление MinorToyClass { UncategorizedToy, ToyRobot, ToyVehicle, ToyDoll, ToyController, ToyGame }
перечисление MinorWearableClass { UncategorizedWearableDevice, WearableWristWatch, WearablePager, WearableJacket, WearableHelmet, WearableGlasses }
перечисление ServiceClass { NoService, PositioningService, NetworkingService, RenderingService, ..., AllServices }
флаги ServiceClasses

Публичные функции

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
MajorDeviceClass majorDeviceClass() const
quint8 minorDeviceClass() const
QString name() const
qint16 rssi() const
ServiceClasses serviceClasses() const
QList<QBluetoothUuid> serviceUuids(DataCompleteness *completeness = Q_NULLPTR) const
DataCompleteness serviceUuidsCompleteness() const
void setCached(bool cached)
void setCoreConfigurations(QBluetoothDeviceInfo::CoreConfigurations coreConfigs)
void setDeviceUuid(const QBluetoothUuid &uuid)
void setRssi(qint16 signal)
void setServiceUuids(const QList<QBluetoothUuid> &uuids, DataCompleteness completeness)
bool operator!=(const QBluetoothDeviceInfo &other) const
QBluetoothDeviceInfo & operator=(const QBluetoothDeviceInfo &other)
bool operator==(const QBluetoothDeviceInfo &other) const

Подробное описание

Класс QBluetoothDeviceInfo хранит информацию об устройстве Bluetooth.

QBluetoothDeviceInfo предоставляет информацию о имени, адресе и классе устройства Bluetooth.

Документация по типам членов

перечисление QBluetoothDeviceInfo::CoreConfigurationфлаги QBluetoothDeviceInfo::CoreConfigurations

Это перечисление описывает конфигурацию устройства.

Константа Значение Описание
QBluetoothDeviceInfo::UnknownCoreConfiguration 0x0 Тип устройства Bluetooth определить невозможно.
QBluetoothDeviceInfo::BaseRateCoreConfiguration 0x02 Устройство — стандартное устройство Bluetooth.
QBluetoothDeviceInfo::BaseRateAndLowEnergyCoreConfiguration 0x03 Устройство — устройство Bluetooth Smart с поддержкой стандартных и устройств с низким энергопотреблением.
QBluetoothDeviceInfo::LowEnergyCoreConfiguration 0x01 Устройство — устройство Bluetooth с низким энергопотреблением.

Этот перечисление был введён или изменён в Qt 5.4.

Тип CoreConfigurations — псевдоним для QFlags<CoreConfiguration>. Он хранит логическое ИЛИ сочетание значений CoreConfiguration.

enum QBluetoothDeviceInfo::DataCompleteness

Это перечисление описывает полноту полученных данных.

Константа Значение Описание
QBluetoothDeviceInfo::DataComplete 0 Данные полные.
QBluetoothDeviceInfo::DataIncomplete 1 Данные неполные. Дополнительные данные доступны через другие интерфейсы.
QBluetoothDeviceInfo::DataUnavailable 2 Данные недоступны.

enum QBluetoothDeviceInfo::MajorDeviceClass

Это перечисление описывает основной класс устройства Bluetooth.

Константа Значение Описание
QBluetoothDeviceInfo::MiscellaneousDevice 0 Разное устройство.
QBluetoothDeviceInfo::ComputerDevice 1 Устройство компьютера или КПК.
QBluetoothDeviceInfo::PhoneDevice 2 Устройство телефона.
QBluetoothDeviceInfo::LANAccessDevice 3 Устройство, обеспечивающее доступ к локальной сети.
QBluetoothDeviceInfo::AudioVideoDevice 4 Устройство, способное воспроизводить или записывать аудио и/или видео.
QBluetoothDeviceInfo::PeripheralDevice 5 Периферийное устройство, например, клавиатура, мышь и т.д.
QBluetoothDeviceInfo::ImagingDevice 6 Устройство обработки изображений, такое как дисплей, принтер, сканер или камера.
QBluetoothDeviceInfo::WearableDevice 7 Носимое устройство, например, часы или пейджер.
QBluetoothDeviceInfo::ToyDevice 8 Игрушка.
QBluetoothDeviceInfo::HealthDevice 9 Устройство, связанное со здоровьем, например, монитор частоты сердечных сокращений или температуры.
QBluetoothDeviceInfo::UncategorizedDevice 31 Устройство, которое не подходит ни к одному из других классов устройств.

enum QBluetoothDeviceInfo::MinorAudioVideoClass

Этот перечисление описывает мелкие классы устройств для аудио/видео устройств.

Постоянная Значение Описание
QBluetoothDeviceInfo::UncategorizedAudioVideoDevice 0 Некатегоризированное аудио/видео устройство.
QBluetoothDeviceInfo::WearableHeadsetDevice 1 Устройство гарнитуры для ношения.
QBluetoothDeviceInfo::HandsFreeDevice 2 Устройство громкой связи.
QBluetoothDeviceInfo::Microphone 4 Микрофон.
QBluetoothDeviceInfo::Loudspeaker 5 Динамик.
QBluetoothDeviceInfo::Headphones 6 Наушники.
QBluetoothDeviceInfo::PortableAudioDevice 7 Портативное аудиоустройство.
QBluetoothDeviceInfo::CarAudio 8 Аудиоустройство для автомобиля.
QBluetoothDeviceInfo::SetTopBox 9 Приставка к телевизору.
QBluetoothDeviceInfo::HiFiAudioDevice 10 Аудиоустройство HiFi.
QBluetoothDeviceInfo::Vcr 11 Видеомагнитофон.
QBluetoothDeviceInfo::VideoCamera 12 Видеокамера.
QBluetoothDeviceInfo::Camcorder 13 Видеокамера.
QBluetoothDeviceInfo::VideoMonitor 14 Видеомонитор.
QBluetoothDeviceInfo::VideoDisplayAndLoudspeaker 15 Видеодисплей со встроенным динамиком.
QBluetoothDeviceInfo::VideoConferencing 16 Устройство для видеоконференций.
QBluetoothDeviceInfo::GamingDevice 18 Игровое устройство.

enum QBluetoothDeviceInfo::MinorComputerClass

Это перечисление описывает мелкие классы устройств для компьютерных устройств.

Постоянная Значение Описание
QBluetoothDeviceInfo::UncategorizedComputer 0 Некатегоризированное компьютерное устройство.
QBluetoothDeviceInfo::DesktopComputer 1 Настольный компьютер.
QBluetoothDeviceInfo::ServerComputer 2 Сервер.
QBluetoothDeviceInfo::LaptopComputer 3 Ноутбук.
QBluetoothDeviceInfo::HandheldClamShellComputer 4 Книжка с компьютером или КПК.
QBluetoothDeviceInfo::HandheldComputer 5 КПК.
QBluetoothDeviceInfo::WearableComputer 6 Носимое компьютерное устройство.

enum QBluetoothDeviceInfo::MinorHealthClass

Это перечисление описывает мелкие классы устройств для устройств здравоохранения.

Постоянная Значение Описание
QBluetoothDeviceInfo::UncategorizedHealthDevice 0 Некатегоризированное медицинское устройство.
QBluetoothDeviceInfo::HealthBloodPressureMonitor 0x1 Тонометр.
QBluetoothDeviceInfo::HealthThermometer 0x2 Термометр.
QBluetoothDeviceInfo::HealthWeightScale 0x3 Весы.
QBluetoothDeviceInfo::HealthGlucoseMeter 0x4 Глюкометр.
QBluetoothDeviceInfo::HealthPulseOximeter 0x5 Пульсоксиметр.
QBluetoothDeviceInfo::HealthDataDisplay 0x7 Дисплей данных.
QBluetoothDeviceInfo::HealthStepCounter 0x8 Шагомер.

enum QBluetoothDeviceInfo::MinorImagingClass

Это перечисление описывает мелкие классы устройств для устройств отображения изображений.

Постоянная Значение Описание
QBluetoothDeviceInfo::UncategorizedImagingDevice 0 Устройство отображения изображений без категории.
QBluetoothDeviceInfo::ImageDisplay 0x04 Устройство, способное отображать изображения.
QBluetoothDeviceInfo::ImageCamera 0x08 Фотокамера.
QBluetoothDeviceInfo::ImageScanner 0x10 Сканер изображений.
QBluetoothDeviceInfo::ImagePrinter 0x20 Принтер.

enum QBluetoothDeviceInfo::MinorMiscellaneousClass

Этот перечисление описывает классы устройств низкого уровня для различных устройств Bluetooth.

Постоянная Значение Описание
QBluetoothDeviceInfo::UncategorizedMiscellaneous 0 Разное устройство без категории.

enum QBluetoothDeviceInfo::MinorNetworkClass

Это перечисление описывает классы устройств низкого уровня для устройств доступа к локальной сети. Устройства доступа к локальной сети используют класс устройства низкого уровня для указания текущей загрузки сети.

Постоянная Значение Описание
QBluetoothDeviceInfo::NetworkFullService 0x00 Доступно 100% всей полосы пропускания.
QBluetoothDeviceInfo::NetworkLoadFactorOne 0x08 В настоящее время используется 0-17% от всей полосы пропускания.
QBluetoothDeviceInfo::NetworkLoadFactorTwo 0x10 В настоящее время используется 17-33% от всей полосы пропускания.
QBluetoothDeviceInfo::NetworkLoadFactorThree 0x18 В настоящее время используется 33-50% от всей полосы пропускания.
QBluetoothDeviceInfo::NetworkLoadFactorFour 0x20 В настоящее время используется 50-67% от всей полосы пропускания.
QBluetoothDeviceInfo::NetworkLoadFactorFive 0x28 В настоящее время используется 67-83% от всей полосы пропускания.
QBluetoothDeviceInfo::NetworkLoadFactorSix 0x30 В настоящее время используется 83-99% от всей полосы пропускания.
QBluetoothDeviceInfo::NetworkNoService 0x38 Нет доступной сетевой службы.

enum QBluetoothDeviceInfo::MinorPeripheralClass

Это перечисление описывает классы устройств низкого уровня для периферийных устройств.

Постоянная Значение Описание
QBluetoothDeviceInfo::UncategorizedPeripheral 0 Неопределенное периферийное устройство.
QBluetoothDeviceInfo::KeyboardPeripheral 0x10 Клавиатура.
QBluetoothDeviceInfo::PointingDevicePeripheral 0x20 Указательное устройство, например, мышь.
QBluetoothDeviceInfo::KeyboardWithPointingDevicePeripheral 0x30 Клавиатура с встроенным указательным устройством.
QBluetoothDeviceInfo::JoystickPeripheral 0x01 Джойстик.
QBluetoothDeviceInfo::GamepadPeripheral 0x02 Игровая контроллер.
QBluetoothDeviceInfo::RemoteControlPeripheral 0x03 Пульт дистанционного управления.
QBluetoothDeviceInfo::SensingDevicePeripheral 0x04 Датчик.
QBluetoothDeviceInfo::DigitizerTabletPeripheral 0x05 Периферийное устройство - планшетный дигитайзер.
QBluetoothDeviceInfo::CardReaderPeripheral 0x06 Периферийное устройство - ридер карт.

enum QBluetoothDeviceInfo::MinorPhoneClass

Этот перечисление описывает классы младших устройств для телефонов.

Константа Значение Описание
QBluetoothDeviceInfo::UncategorizedPhone 0 Некатегоризированное устройство телефона.
QBluetoothDeviceInfo::CellularPhone 1 Сотовый телефон.
QBluetoothDeviceInfo::CordlessPhone 2 Беспроводной телефон.
QBluetoothDeviceInfo::SmartPhone 3 Смартфон.
QBluetoothDeviceInfo::WiredModemOrVoiceGatewayPhone 4 Проводной модем или шлюз голосовой связи.
QBluetoothDeviceInfo::CommonIsdnAccessPhone 5 Устройство, предоставляющее доступ ISDN.

enum QBluetoothDeviceInfo::MinorToyClass

Это перечисление описывает классы младших устройств для игрушек.

Константа Значение Описание
QBluetoothDeviceInfo::UncategorizedToy 0 Некатегоризированная игрушка.
QBluetoothDeviceInfo::ToyRobot 1 Игрушечный робот.
QBluetoothDeviceInfo::ToyVehicle 2 Игрушевое транспортное средство.
QBluetoothDeviceInfo::ToyDoll 3 Игрушечная кукла или фигурки.
QBluetoothDeviceInfo::ToyController 4 Контроллер.
QBluetoothDeviceInfo::ToyGame 5 Игра.

enum QBluetoothDeviceInfo::MinorWearableClass

Это перечисление описывает классы младших устройств для носимых устройств.

Константа Значение Описание
QBluetoothDeviceInfo::UncategorizedWearableDevice 0 Некатегоризированное носимое устройство.
QBluetoothDeviceInfo::WearableWristWatch 1 Часы.
QBluetoothDeviceInfo::WearablePager 2 Передатчик сообщений.
QBluetoothDeviceInfo::WearableJacket 3 Куртка.
QBluetoothDeviceInfo::WearableHelmet 4 Шлем.
QBluetoothDeviceInfo::WearableGlasses 5 Очки.

enum QBluetoothDeviceInfo::ServiceClassflags QBluetoothDeviceInfo::ServiceClasses

Это перечисление описывает класс сервиса Bluetooth-устройства. Класс сервиса используется как примитивная форма обнаружения сервисов. Он предназначен для предоставления списка типов сервисов, которые может предоставлять устройство.

Константа Значение Описание
QBluetoothDeviceInfo::NoService 0x0000 Устройство не предоставляет никаких услуг.
QBluetoothDeviceInfo::PositioningService 0x0001 Устройство предоставляет услуги позиционирования.
QBluetoothDeviceInfo::NetworkingService 0x0002 Устройство предоставляет сетевые услуги.
QBluetoothDeviceInfo::RenderingService 0x0004 Устройство предоставляет услуги отображения.
QBluetoothDeviceInfo::CapturingService 0x0008 Устройство предоставляет услуги захвата.
QBluetoothDeviceInfo::ObjectTransferService 0x0010 Устройство предоставляет услуги передачи объектов.
QBluetoothDeviceInfo::AudioService 0x0020 Устройство предоставляет аудиоуслуги.
QBluetoothDeviceInfo::TelephonyService 0x0040 Устройство предоставляет услуги телефонии.
QBluetoothDeviceInfo::InformationService 0x0080 Устройство предоставляет информационные услуги.
QBluetoothDeviceInfo::AllServices 0x07ff Устройство предоставляет услуги всех типов.

Тип ServiceClasses — это typedef для QFlags<ServiceClass>. Он хранит логическое ИЛИ сочетание значений ServiceClass.

Документация по членам-функциям

QBluetoothDeviceInfo::QBluetoothDeviceInfo()

Создает объект QBluetoothDeviceInfo в недопустимом состоянии.

QBluetoothDeviceInfo::QBluetoothDeviceInfo(const QBluetoothAddress &address, const QString &name, quint32 classOfDevice)

Создает объект QBluetoothDeviceInfo с адресом Bluetooth address, именем устройства name и кодированным классом устройства classOfDevice.

Параметр classOfDevice закодирован в следующем формате:

Биты Размер Описание
0 - 1 2 Не используется, установлено в 0.
2 - 7 6 Младший класс устройства.
8 - 12 5 Старший класс устройства.
13 - 23 11 Класс службы.

QBluetoothDeviceInfo::QBluetoothDeviceInfo(const QBluetoothUuid &uuid, const QString &name, quint32 classOfDevice)

Создаёт объект QBluetoothDeviceInfo с уникальным идентификатором uuid, именем устройства name и кодированным классом устройства classOfDevice.

Этот конструктор необходим для устройств Low Energy на macOS и iOS. API CoreBluetooth скрывает адреса и предоставляет уникальные UUID для идентификации устройства. Этот UUID не является тем же, что и UUID службы, и необходим для дальнейшей работы с API CoreBluetooth и обнаруженными устройствами.

Данная функция была добавлена в Qt 5.5.

QBluetoothDeviceInfo::QBluetoothDeviceInfo(const QBluetoothDeviceInfo &other)

Создаёт копию объекта QBluetoothDeviceInfo из other.

QBluetoothDeviceInfo::~QBluetoothDeviceInfo()

Удаляет объект QBluetoothDeviceInfo.

QBluetoothAddress QBluetoothDeviceInfo::address() const

Возвращает адрес устройства.

Примечание: На iOS и macOS этот адрес недействителен. Вместо этого следует использовать deviceUuid(). Эти платформы не предоставляют адреса Bluetooth для обнаруженных устройств Bluetooth и используют уникальные идентификаторы устройств.

См. также deviceUuid().

QBluetoothDeviceInfo::CoreConfigurations QBluetoothDeviceInfo::coreConfigurations() const

Возвращает конфигурацию устройства. Если конфигурация устройства не установлена, возвращается базовая конфигурация устройства с базовой скоростью.

Эта функция была добавлена в Qt 5.4.

См. также setCoreConfigurations().

QBluetoothUuid QBluetoothDeviceInfo::deviceUuid() const

Возвращает уникальный идентификатор устройства Bluetooth без адреса.

В целом, этот UUID недействителен на всех платформах, кроме macOS и iOS. Он используется как обходной путь для этих двух платформ, поскольку они не предоставляют адреса Bluetooth для обнаруженных устройств Bluetooth Low Energy. На других платформах используется address().

Эта функция была добавлена в Qt 5.5.

См. также setDeviceUuid().

bool QBluetoothDeviceInfo::isCached() const

Возвращает true, если объект QBluetoothDeviceInfo создан из кэшированных данных.

bool QBluetoothDeviceInfo::isValid() const

Возвращает true, если объект QBluetoothDeviceInfo действителен, иначе возвращает false.

MajorDeviceClass QBluetoothDeviceInfo::majorDeviceClass() const

Возвращает основной класс устройства.

quint8 QBluetoothDeviceInfo::minorDeviceClass() const

Возвращает младший класс устройства. Фактическая информация зависит от значения majorDeviceClass().

См. также MinorAudioVideoClass, MinorComputerClass, MinorHealthClass, MinorImagingClass, MinorMiscellaneousClass, MinorNetworkClass, MinorPeripheralClass, MinorPhoneClass, MinorToyClass и MinorWearableClass.

QString QBluetoothDeviceInfo::name() const

Возвращает имя, назначенное устройству.

qint16 QBluetoothDeviceInfo::rssi() const

Возвращает силу сигнала во время последнего сканирования устройства.

См. также setRssi().

ServiceClasses QBluetoothDeviceInfo::serviceClasses() const

Возвращает класс службы устройства.

QList<QBluetoothUuid> QBluetoothDeviceInfo::serviceUuids(DataCompleteness *completeness = Q_NULLPTR) const

Возвращает список UUID служб, поддерживаемых устройством. Если completeness не равен 0, он будет установлен в DataComplete, и возвращается полный список UUID, поддерживаемых устройством. DataIncomplete, если устройство поддерживает дополнительные UUID служб, и DataUnavailable, если информация о UUID служб недоступна.

Эта функция требует, чтобы устройства Bluetooth поддерживали спецификацию 2.1.

См. также setServiceUuids().

DataCompleteness QBluetoothDeviceInfo::serviceUuidsCompleteness() const

Возвращает полноту списка UUID служб. Если возвращается DataComplete, serviceUuids() возвращает полный список UUID служб, поддерживаемых устройством, в противном случае — только частичный или пустой список UUID служб. Для получения списка всех поддерживаемых устройством служб необходимо выполнить полное обнаружение служб.

void QBluetoothDeviceInfo::setCached(bool cached)

Используется системой для установки флага cached, если QBluetoothDeviceInfo создан из кэшированных данных. Кэшированная информация может быть менее точной, чем данные, считанные с активного устройства.

См. также isCached().

void QBluetoothDeviceInfo::setCoreConfigurations(QBluetoothDeviceInfo::CoreConfigurations coreConfigs)

Устанавливает CoreConfigurations устройства на coreConfigs. Это поможет отличить обычные устройства от устройств Low Energy.

Эта функция была добавлена в Qt 5.4.

См. также coreConfigurations().

void QBluetoothDeviceInfo::setDeviceUuid(const QBluetoothUuid &uuid)

Устанавливает уникальный идентификатор uuid для устройств Bluetooth, у которых нет адресов. Это происходит на macOS и iOS, где API CoreBluetooth скрывает адреса, но предоставляет UUID для идентификации устройств/периферийных устройств.

Этот UUID недействителен на других платформах.

Эта функция была добавлена в Qt 5.5.

См. также deviceUuid().

void QBluetoothDeviceInfo::setRssi(qint16 signal)

Устанавливает значение силы сигнала signal, используемое внутри.

См. также rssi().

void QBluetoothDeviceInfo::setServiceUuids(const QList<QBluetoothUuid> &uuids, DataCompleteness completeness)

Устанавливает список UUID служб на uuids и полноту данных на completeness.

См. также serviceUuids().

bool QBluetoothDeviceInfo::operator!=(const QBluetoothDeviceInfo &other) const

Возвращает true, если этот объект отличается от other, иначе false.

См. также operator==().

QBluetoothDeviceInfo &QBluetoothDeviceInfo::operator=(const QBluetoothDeviceInfo &other)

Создаёт копию other и присваивает её этому объекту QBluetoothDeviceInfo.

bool QBluetoothDeviceInfo::operator==(const QBluetoothDeviceInfo &other) const

Возвращает true, если объект other QBluetoothDeviceInfo и этот объект идентичны.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/archives/qt-5.6/qbluetoothdeviceinfo.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API