QLowEnergyCharacteristic Class

Documentation des fonctions membres

QLowEnergyCharacteristic::QLowEnergyCharacteristic()

Construit une nouvelle QLowEnergyCharacteristic. Une instance de cette classe construite par défaut est toujours invalide.

Voir également isValid().

QLowEnergyCharacteristic::QLowEnergyCharacteristic(const QLowEnergyCharacteristic &other)

Construire une nouvelle QLowEnergyCharacteristic 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] QLowEnergyCharacteristic::~QLowEnergyCharacteristic()

Détruit 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 s'il n'existe pas de descripteur de configuration des caractéristiques du client.

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, alors que les indications le sont. Les notifications sont considérées comme plus rapides, mais peu fiables, tandis que les indications sont plus lentes et plus fiables.

Si une caractéristique prend en charge la notification ou l'indication, celles-ci peuvent être activées en écrivant des schémas de bits spéciaux dans le descripteur de configuration de la caractéristique du client. Pour des raisons de commodité, ces schémas binaires sont désignés par QLowEnergyCharacteristic::CCCDDisable, QLowEnergyCharacteristic::CCCDEnableNotification, et QLowEnergyCharacteristic::CCCDEnableIndication.

L'activation, par exemple, de la notification d'une caractéristique nommée mycharacteristic dans un service appelé myservice peut être réalisé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

Retourne le descripteur de uuid ou une instance invalide de QLowEnergyDescriptor.

Voir aussi descriptors().

QList<QLowEnergyDescriptor> QLowEnergyCharacteristic::descriptors() const

Renvoie la liste des descripteurs appartenant à 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 caractéristique non valide n'est associé à 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.

QString QLowEnergyCharacteristic::name() const

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

Le nom est basé sur la caractéristique uuid() qui doit avoir été normalisée. La liste complète des types de caractéristiques se trouve sous Bluetooth.org Characteristics.

La chaîne renvoyée est vide si la caractéristique uuid() est inconnue.

Voir également QBluetoothUuid::characteristicToString().

QLowEnergyCharacteristic::PropertyTypes QLowEnergyCharacteristic::properties() const

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

Les 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 isValid() renvoie true; sinon un UUID null.

QByteArray QLowEnergyCharacteristic::value() const

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

Si properties() permet l'écriture de nouvelles valeurs, la valeur peut être mise à jour à l'aide de QLowEnergyService::writeCharacteristic().

Le cache est mis à jour lors de l'exécution du service associé detail discovery, d'une opération read/write réussie ou de la réception d'une notification de mise à jour.

L'adresse QByteArray renvoyée reste toujours vide si la caractéristique n'a pas la valeur read permission. Dans ce cas, seules les adresses QLowEnergyService::characteristicChanged() ou QLowEnergyService::characteristicWritten() peuvent fournir des informations sur la valeur de cette caractéristique.

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

Fait une copie de other et l'affecte à l'objet QLowEnergyCharacteristic. Les deux copies continuent à partager les mêmes détails de service et de contrôleur.