Класс QLowEnergyDescriptor

Класс QLowEnergyDescriptor хранит информацию о дескрипторе Bluetooth Low Energy. Подробнее...

• Список всех членов, включая унаследованные

Открытые функции

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

Класс QLowEnergyDescriptor хранит информацию о дескрипторе Bluetooth Low Energy.

QLowEnergyDescriptor предоставляет информацию о имени (name()), UUID (uuid()), значении (value()) и дескрипторном обработчике (handle()) дескриптора Bluetooth Low Energy. Дескрипторы инкапсулированы характеристиками Bluetooth Low Energy и предоставляют дополнительную контекстуальную информацию о характеристике (формат данных, активация уведомлений и т. д.).

Значение дескриптора можно записать с помощью экземпляра QLowEnergyService, который управляет сервисом, к которому относится этот дескриптор. Функция QLowEnergyService::writeDescriptor() записывает новое значение. При успехе генерируется сигнал QLowEnergyService::descriptorWritten(). Кэшированное значение value() этого объекта обновляется соответствующим образом.

См. также QLowEnergyService и QLowEnergyCharacteristic.

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

QLowEnergyDescriptor::QLowEnergyDescriptor()

Создает новый QLowEnergyDescriptor. Экземпляр, созданный по умолчанию, всегда невалиден.

QLowEnergyDescriptor::QLowEnergyDescriptor(const QLowEnergyDescriptor &other)

Создает новый QLowEnergyDescriptor, который является копией other.

Обе копии продолжают совместно использовать одни и те же данные, которые не отсоединяются при записи.

QLowEnergyDescriptor::~QLowEnergyDescriptor()

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

QLowEnergyHandle QLowEnergyDescriptor::handle() const

Возвращает дескрипторный обработчик или 0 , если обработчик недоступен на платформе или дескриптор невалиден.

Примечание: На macOS и iOS обработчики могут отличаться от 0, но эти значения не имеют специального смысла вне внутренних/частных API.

bool QLowEnergyDescriptor::isValid() const

Возвращает true , если объект QLowEnergyDescriptor валиден, в противном случае возвращает false.

Невалидный экземпляр дескриптора не связан ни с каким сервисом (созданный по умолчанию) или связанный сервис больше не валиден из-за разрыва соединения с базовым устройством Bluetooth Low Energy, например. После того, как объект становится невалидным, он больше не может стать валидным.

Примечание: Если экземпляр QLowEnergyDescriptor становится невалидным из-за разрыва соединения с базовым устройством, информация, инкапсулированная текущим экземпляром, остается такой, как она была на момент разрыва соединения. Поэтому ее можно получить после события разрыва соединения.

QString QLowEnergyDescriptor::name() const

Возвращает имя дескриптора в читаемом человеком формате.

Имя основано на типе дескриптора (type()). Полный список типов дескрипторов можно найти на Bluetooth.org Descriptors.

Возвращаемая строка пуста, если тип (type()) неизвестен.

См. также type() и QBluetoothUuid::descriptorToString().

QBluetoothUuid::DescriptorType QLowEnergyDescriptor::type() const

Возвращает тип дескриптора.

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

QBluetoothUuid QLowEnergyDescriptor::uuid() const

Возвращает UUID этого дескриптора, если isValid() возвращает true; в противном случае — нулевой UUID.

QByteArray QLowEnergyDescriptor::value() const

Возвращает кэшированное значение дескриптора.

Кэшированное значение дескриптора может быть обновлено с помощью QLowEnergyService::writeDescriptor() или QLowEnergyService::readDescriptor().

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

Возвращает true , если other не равно этому QLowEnergyCharacteristic; в противном случае false.

Два экземпляра QLowEnergyDescriptor считаются равными, если они ссылаются на один и тот же дескриптор на одном и том же удалённом устройстве Bluetooth Low Energy или оба экземпляра были созданы по умолчанию.

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

Создает копию other и присваивает её этому объекту QLowEnergyDescriptor. Обе копии продолжают совместно использовать те же данные сервиса и контроллера.

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

Возвращает true , если other равно этому QLowEnergyCharacteristic; в противном случае false.

Два экземпляра QLowEnergyDescriptor считаются равными, если они ссылаются на один и тот же дескриптор на одном и том же удалённом устройстве Bluetooth Low Energy или оба экземпляра были созданы по умолчанию.