QLowEnergyDescriptor Class
Die Klasse „QLowEnergyDescriptor“ speichert Informationen zum Bluetooth-Low-Energy-Deskriptor. Mehr...
| Header: | #include <QLowEnergyDescriptor> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Bluetooth) target_link_libraries(mytarget PRIVATE Qt6::Bluetooth) |
| qmake: | QT += bluetooth |
Öffentliche Funktionen
| QLowEnergyDescriptor() | |
| QLowEnergyDescriptor(const QLowEnergyDescriptor &other) | |
| ~QLowEnergyDescriptor() | |
| bool | isValid() const |
| QString | name() const |
| QBluetoothUuid::DescriptorType | type() const |
| QBluetoothUuid | uuid() const |
| QByteArray | value() const |
| QLowEnergyDescriptor & | operator=(const QLowEnergyDescriptor &other) |
Zugehörige Nicht-Mitglieder
| bool | operator!=(const QLowEnergyDescriptor &a, const QLowEnergyDescriptor &b) |
| bool | operator==(const QLowEnergyDescriptor &a, const QLowEnergyDescriptor &b) |
Ausführliche Beschreibung
QLowEnergyDescriptor liefert Informationen über die Eigenschaften „ name “ (), „ uuid “ () und „ value “ () eines Bluetooth-Low-Energy-Deskriptors. Deskriptoren sind in Bluetooth-Low-Energy-Merkmalen gekapselt und liefern zusätzliche Kontextinformationen zum Merkmal (Datenformat, Aktivierung von Benachrichtigungen usw.).
Der Deskriptorwert kann über die Instanz „ QLowEnergyService “ geschrieben werden, die den Dienst verwaltet, zu dem dieser Deskriptor gehört. Die Funktion „ QLowEnergyService::writeDescriptor()“ schreibt den neuen Wert. Bei Erfolg wird das Signal „ QLowEnergyService::descriptorWritten()“ ausgesendet. Die zwischengespeicherte „ value()“ dieses Objekts wird entsprechend aktualisiert.
Siehe auch „ QLowEnergyService “ und „ QLowEnergyCharacteristic “.
Dokumentation zu den Member-Funktionen
QLowEnergyDescriptor::QLowEnergyDescriptor()
Erstellen Sie einen neuen `QLowEnergyDescriptor`. Eine mit dem Standardkonstruktor erstellte Instanz dieser Klasse ist immer ungültig.
QLowEnergyDescriptor::QLowEnergyDescriptor(const QLowEnergyDescriptor &other)
Erstellen Sie einen neuen `QLowEnergyDescriptor`, der eine Kopie von ` other` ist.
Die beiden Kopien nutzen weiterhin dieselben zugrunde liegenden Daten, die beim Schreiben nicht getrennt werden.
[noexcept] QLowEnergyDescriptor::~QLowEnergyDescriptor()
Löscht das Objekt „ QLowEnergyDescriptor “.
bool QLowEnergyDescriptor::isValid() const
Gibt „ true “ zurück, wenn das „ QLowEnergyDescriptor “-Objekt gültig ist, andernfalls „ false “.
Eine ungültige Descriptor-Instanz ist keinem Dienst zugeordnet (standardmäßig erstellt) oder der zugehörige Dienst ist nicht mehr gültig, beispielsweise aufgrund einer Unterbrechung der Verbindung zum zugrunde liegenden Bluetooth Low Energy-Gerät. Sobald das Objekt ungültig ist, kann es nicht mehr gültig werden.
Hinweis: Wenn eine „ QLowEnergyDescriptor “-Instanz aufgrund einer Unterbrechung der Verbindung zum zugrunde liegenden Gerät ungültig wird, bleiben die von der aktuellen Instanz gekapselten Informationen so erhalten, wie sie zum Zeitpunkt der Unterbrechung waren. Daher können sie nach dem Verbindungsabbruch abgerufen werden.
QString QLowEnergyDescriptor::name() const
Gibt den für Menschen lesbaren Namen des Deskriptors zurück.
Der Name basiert auf dem „ type “ () des Deskriptors. Die vollständige Liste der Deskriptortypen finden Sie unter „Bluetooth.org Descriptors“.
Die zurückgegebene Zeichenkette ist leer, wenn die „ type “ () unbekannt ist.
Siehe auch „ type()“ und „ QBluetoothUuid::descriptorToString()“.
QBluetoothUuid::DescriptorType QLowEnergyDescriptor::type() const
Gibt den Typ des Deskriptors zurück.
Siehe auch ` name()`.
QBluetoothUuid QLowEnergyDescriptor::uuid() const
Gibt die UUID dieses Deskriptors zurück, wenn ` isValid()` die UUID ` true` zurückgibt; andernfalls die UUID ` null `.
QByteArray QLowEnergyDescriptor::value() const
Gibt den zwischengespeicherten Wert des Deskriptors zurück.
Der zwischengespeicherte Wert des Deskriptors kann mit den Funktionen „ QLowEnergyService::writeDescriptor()“ oder „ QLowEnergyService::readDescriptor()“ aktualisiert werden.
QLowEnergyDescriptor &QLowEnergyDescriptor::operator=(const QLowEnergyDescriptor &other)
Erstellt eine Kopie von „ other “ und ordnet sie diesem „ QLowEnergyDescriptor “-Objekt zu. Die beiden Kopien nutzen weiterhin dieselben Dienst- und Controller-Details.
Verwandte Nicht-Mitglieder
bool operator!=(const QLowEnergyDescriptor &a, const QLowEnergyDescriptor &b)
Gibt „ true “ zurück, wenn „ a “ nicht gleich „ b “ ist; andernfalls „ false “.
Zwei Instanzen von ` QLowEnergyDescriptor ` gelten als gleich, wenn sie sich auf denselben Deskriptor auf demselben entfernten Bluetooth-Low-Energy-Gerät beziehen oder wenn beide Instanzen standardmäßig initialisiert wurden.
bool operator==(const QLowEnergyDescriptor &a, const QLowEnergyDescriptor &b)
Gibt „ true “ zurück, wenn „ a “ gleich „ b “ ist; andernfalls „ false “.
Zwei Instanzen von ` QLowEnergyDescriptor ` gelten als gleich, wenn sie sich auf denselben Deskriptor auf demselben entfernten Bluetooth-Low-Energy-Gerät beziehen oder wenn beide Instanzen standardmäßig initialisiert wurden.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
