QLowEnergyDescriptor Class
La classe QLowEnergyDescriptor stocke des informations sur le descripteur Bluetooth Low Energy. Plus d'informations...
| 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) |
Non-membres apparenté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 descripteurs Bluetooth Low Energy name(), uuid() et value(). 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 de la notification, etc.).
La valeur du descripteur peut être écrite via l'instance QLowEnergyService qui gère le service auquel ce descripteur appartient. La fonction QLowEnergyService::writeDescriptor() écrit la nouvelle valeur. Le signal QLowEnergyService::descriptorWritten() est émis en cas de succès. Le cache value() de cet objet est mis à jour en conséquence.
Voir également QLowEnergyService et QLowEnergyCharacteristic.
Documentation des fonctions membres
QLowEnergyDescriptor::QLowEnergyDescriptor()
Construit un nouveau QLowEnergyDescriptor. Une instance de cette classe construite par défaut est toujours invalide.
QLowEnergyDescriptor::QLowEnergyDescriptor(const QLowEnergyDescriptor &other)
Construire un nouveau QLowEnergyDescriptor qui est une copie de other.
Les deux copies continuent à partager les mêmes données sous-jacentes qui ne se détachent pas lors de l'écriture.
[noexcept] QLowEnergyDescriptor::~QLowEnergyDescriptor()
Détruit 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 (construit par défaut) ou le service associé n'est plus valide en raison d'une déconnexion du dispositif Bluetooth Low Energy sous-jacent, par exemple. Une fois que l'objet est invalide, il ne peut plus devenir valide.
Remarque : si une instance QLowEnergyDescriptor devient invalide à la suite d'une déconnexion du dispositif 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'homme du descripteur.
Le nom est basé sur l'adresse type() du descripteur. La liste complète des types de descripteurs est disponible sous Descripteurs Bluetooth.org.
La chaîne renvoyée est vide si le type() est inconnu.
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 isValid() renvoie true; sinon un UUID null.
QByteArray QLowEnergyDescriptor::value() const
Renvoie la valeur mise en cache du descripteur.
La valeur du descripteur mis en cache peut être mise à jour en utilisant QLowEnergyService::writeDescriptor() ou QLowEnergyService::readDescriptor().
QLowEnergyDescriptor &QLowEnergyDescriptor::operator=(const QLowEnergyDescriptor &other)
Fait une copie de other et l'affecte à l'objet QLowEnergyDescriptor. Les deux copies continuent de partager les mêmes détails de service et de contrôleur.
Non-membres apparenté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 se réfèrent au même descripteur sur le même dispositif 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 appareil 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.
