QLowEnergyDescriptor Class
La classe `QLowEnergyDescriptor` stocke des informations relatives au descripteur Bluetooth Low Energy. En savoir plus...
| En-tête : | #include <QLowEnergyDescriptor> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Bluetooth) target_link_libraries(mytarget PRIVATE Qt6::Bluetooth) |
| qmake : | QT += bluetooth |
Fonctions publiques
| 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) |
Éléments non membres associés
| bool | operator!=(const QLowEnergyDescriptor &a, const QLowEnergyDescriptor &b) |
| bool | operator==(const QLowEnergyDescriptor &a, const QLowEnergyDescriptor &b) |
Description détaillée
QLowEnergyDescriptor fournit des informations sur les méthodes name(), uuid() et value() d’un descripteur Bluetooth Low Energy. Les descripteurs sont encapsulés par les caractéristiques Bluetooth Low Energy et fournissent des informations contextuelles supplémentaires sur la caractéristique (format des données, activation des notifications, etc.).
La valeur du descripteur peut être écrite via l’instance QLowEnergyService qui gère le service auquel appartient ce descripteur. La fonction QLowEnergyService::writeDescriptor() écrit la nouvelle valeur. Le signal QLowEnergyService::descriptorWritten() est émis en cas de réussite. La méthode value() mise en cache de cet objet est mise à jour en conséquence.
Voir également QLowEnergyService et QLowEnergyCharacteristic.
Documentation des fonctions membres
QLowEnergyDescriptor::QLowEnergyDescriptor()
Créez un nouvel objet `QLowEnergyDescriptor`. Une instance de cette classe créée par défaut n'est jamais valide.
QLowEnergyDescriptor::QLowEnergyDescriptor(const QLowEnergyDescriptor &other)
Créez un nouvel objet `QLowEnergyDescriptor` qui soit une copie de ` other`.
Les deux copies continuent de partager les mêmes données sous-jacentes, qui ne sont pas dissociées lors de l'écriture.
[noexcept] QLowEnergyDescriptor::~QLowEnergyDescriptor()
Supprime l'objet « QLowEnergyDescriptor ».
bool QLowEnergyDescriptor::isValid() const
Renvoie ` true ` si l'objet ` QLowEnergyDescriptor ` est valide, sinon renvoie ` false`.
Une instance de descripteur invalide n’est associée à aucun service (construction par défaut) ou le service associé n’est plus valide en raison, par exemple, d’une déconnexion du périphérique Bluetooth Low Energy sous-jacent. Une fois que l’objet est invalide, il ne peut plus redevenir valide.
Remarque : si une instance ` QLowEnergyDescriptor ` devient invalide en raison d’une déconnexion du périphérique sous-jacent, les informations encapsulées par l’instance actuelle restent telles qu’elles étaient au moment de la déconnexion. Elles peuvent donc être récupérées après l’événement de déconnexion.
QString QLowEnergyDescriptor::name() const
Renvoie le nom lisible par l'utilisateur du descripteur.
Ce nom est basé sur la fonction ` type()` du descripteur. La liste complète des types de descripteurs est disponible sur Bluetooth.org, dans la section « Descripteurs ».
La chaîne renvoyée est vide si la fonction ` type()` est inconnue.
Voir également ` type()` et ` QBluetoothUuid::descriptorToString()`.
QBluetoothUuid::DescriptorType QLowEnergyDescriptor::type() const
Renvoie le type du descripteur.
Voir aussi name().
QBluetoothUuid QLowEnergyDescriptor::uuid() const
Renvoie l'UUID de ce descripteur si la fonction ` isValid()` renvoie ` true` ; sinon, elle renvoie l'UUID de ` null `.
QByteArray QLowEnergyDescriptor::value() const
Renvoie la valeur mise en cache du descripteur.
La valeur mise en cache du descripteur peut être mise à jour à l'aide des fonctions ` QLowEnergyService::writeDescriptor()` ou ` QLowEnergyService::readDescriptor()`.
QLowEnergyDescriptor &QLowEnergyDescriptor::operator=(const QLowEnergyDescriptor &other)
Crée une copie de other et l'assigne à cet objet QLowEnergyDescriptor. Les deux copies continuent de partager les mêmes informations relatives au service et au contrôleur.
Éléments non membres associés
bool operator!=(const QLowEnergyDescriptor &a, const QLowEnergyDescriptor &b)
Renvoie ` true ` si ` a ` n'est pas égal à ` b` ; sinon, ` false`.
Deux instances de ` QLowEnergyDescriptor ` sont considérées comme égales si elles font référence au même descripteur sur le même périphérique Bluetooth Low Energy distant ou si les deux instances ont été construites par défaut.
bool operator==(const QLowEnergyDescriptor &a, const QLowEnergyDescriptor &b)
Renvoie ` true ` si ` a ` est égal à ` b` ; sinon, ` false`.
Deux instances de ` QLowEnergyDescriptor ` sont considérées comme égales si elles font référence au même descripteur sur le même périphérique Bluetooth Low Energy distant ou si les deux instances ont été construites par défaut.
© 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.
