QLowEnergyCharacteristic Class

Documentation des fonctions membres

QLowEnergyCharacteristic::QLowEnergyCharacteristic()

Construisez un nouvel objet `QLowEnergyCharacteristic`. Une instance de cette classe créée par défaut est toujours invalide.

Voir également isValid().

QLowEnergyCharacteristic::QLowEnergyCharacteristic(const QLowEnergyCharacteristic &other)

Créez un nouvel objet `QLowEnergyCharacteristic` 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] QLowEnergyCharacteristic::~QLowEnergyCharacteristic()

Supprime l'objet « QLowEnergyCharacteristic ».

[since 6.2] QLowEnergyDescriptor QLowEnergyCharacteristic::clientCharacteristicConfiguration() const

Renvoie le descripteur de configuration des caractéristiques du client ou une instance non valide de ` QLowEnergyDescriptor ` si aucun descripteur de configuration des caractéristiques du client n'existe.

Les caractéristiques BTLE peuvent prendre en charge les notifications et/ou les indications. Dans les deux cas, le périphérique informe le central de chaque modification de la valeur de la caractéristique. Dans le protocole d’attributs BTLE, les messages de notification ne sont pas confirmés par le central, contrairement aux indications. Les notifications sont considérées comme plus rapides, mais moins fiables, tandis que les indications sont plus lentes et plus fiables.

Si une caractéristique prend en charge les notifications ou les indications, celles-ci peuvent être activées en écrivant des motifs binaires spécifiques dans le descripteur de configuration des caractéristiques client. Pour plus de commodité, ces motifs binaires sont fournis sous la forme QLowEnergyCharacteristic::CCCDDisable, QLowEnergyCharacteristic::CCCDEnableNotification et QLowEnergyCharacteristic::CCCDEnableIndication.

L’activation, par exemple, de la notification pour une caractéristique nommée mycharacteristic dans un service appelé myservice peut être effectuée à l’aide du code suivant.

auto cccd = mycharacteristic.clientCharacteristicConfiguration();
if (!cccd.isValid()) {
    // your error handling
    return error;
}
myservice->writeDescriptor(cccd, QLowEnergyCharacteristic::CCCDEnableNotification);

Cette fonction a été introduite dans Qt 6.2.

Voir également ` descriptor()`.

QLowEnergyDescriptor QLowEnergyCharacteristic::descriptor(const QBluetoothUuid &uuid) const

Renvoie le descripteur d'uuid ou d'une instance QLowEnergyDescriptor non valide.

Voir aussi descriptors().

QList<QLowEnergyDescriptor> QLowEnergyCharacteristic::descriptors() const

Renvoie la liste des descripteurs associés à cette caractéristique ; sinon, une liste vide.

Voir également descriptor().

bool QLowEnergyCharacteristic::isValid() const

Renvoie « true » si l'objet « QLowEnergyCharacteristic » est valide ; sinon, renvoie « false ».

Un objet de caractéristique invalide n’est associé à 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.

QString QLowEnergyCharacteristic::name() const

Renvoie le nom lisible par l'utilisateur de la caractéristique.

Ce nom est basé sur la valeur de l'uuid() de la caractéristique, qui doit avoir été normalisée. La liste complète des types de caractéristiques est disponible sur Bluetooth.org, sous la rubrique « Characteristics ».

La chaîne renvoyée est vide si la méthode ` uuid()` est inconnue.

Voir également la fonction ` QBluetoothUuid::characteristicToString()`.

QLowEnergyCharacteristic::PropertyTypes QLowEnergyCharacteristic::properties() const

Renvoie les propriétés de la caractéristique.

Ces propriétés définissent les autorisations d'accès à la caractéristique.

QBluetoothUuid QLowEnergyCharacteristic::uuid() const

Renvoie l'UUID de la caractéristique si la fonction ` isValid()` renvoie ` true` ; sinon, elle renvoie l'UUID ` null `.

QByteArray QLowEnergyCharacteristic::value() const

Renvoie la valeur mise en cache de la caractéristique.

Si l'properties() de la caractéristique autorise l'écriture de nouvelles valeurs, celle-ci peut être mise à jour à l'aide de la méthode QLowEnergyService::writeCharacteristic().

Le cache est mis à jour lors de l'appel de la méthode ` detail discovery` du service associé, lors d'une opération réussie ` read` / `write `, ou lorsqu'une notification de mise à jour est reçue.

La méthode QByteArray renvoie toujours une valeur vide si la caractéristique ne dispose pas de la méthode read permission. Dans ce cas, seules les méthodes QLowEnergyService::characteristicChanged() ou QLowEnergyService::characteristicWritten() peuvent fournir des informations sur la valeur de cette caractéristique.

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

Crée une copie de other et l'attribue à cet objet QLowEnergyCharacteristic. Les deux copies continuent de partager les mêmes informations relatives au service et au contrôleur.