Класс 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 или оба экземпляра были созданы по умолчанию.