QLowEnergyCharacteristic Class

Dokumentation der Mitgliedsfunktionen

QLowEnergyCharacteristic::QLowEnergyCharacteristic()

Konstruiert ein neues QLowEnergyCharacteristic. Eine standardmäßig konstruierte Instanz dieser Klasse ist immer ungültig.

Siehe auch isValid().

QLowEnergyCharacteristic::QLowEnergyCharacteristic(const QLowEnergyCharacteristic &other)

Konstruieren Sie eine neue QLowEnergyCharacteristic, die eine Kopie von other ist.

Die beiden Kopien teilen sich weiterhin die gleichen zugrunde liegenden Daten, die beim Schreiben nicht getrennt werden.

[noexcept] QLowEnergyCharacteristic::~QLowEnergyCharacteristic()

Zerstört das Objekt QLowEnergyCharacteristic.

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

Gibt den Client Characteristic Configuration Descriptor zurück oder eine ungültige QLowEnergyDescriptor Instanz, wenn kein Client Characteristic Configuration Descriptor existiert.

BTLE-Merkmale können Benachrichtigungen und/oder Anzeigen unterstützen. In beiden Fällen informiert das Peripheriegerät die Zentrale über jede Änderung des Merkmalswerts. Im BTLE-Attributprotokoll werden Benachrichtigungsmeldungen von der Zentrale nicht bestätigt, während Anzeigen bestätigt werden. Meldungen gelten als schneller, aber unzuverlässiger, während Anzeigen langsamer und zuverlässiger sind.

Wenn ein Merkmal Benachrichtigungen oder Anzeigen unterstützt, können diese durch Schreiben spezieller Bitmuster in den Konfigurationsdeskriptor des Client-Merkmals aktiviert werden. Der Einfachheit halber werden diese Bitmuster als QLowEnergyCharacteristic::CCCDDisable, QLowEnergyCharacteristic::CCCDEnableNotification und QLowEnergyCharacteristic::CCCDEnableIndication angegeben.

Die Aktivierung einer Benachrichtigung für ein Merkmal mit dem Namen mycharacteristic in einem Dienst mit dem Namen myservice könnte z. B. mit dem folgenden Code erfolgen.

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

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch descriptor().

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

Gibt den Deskriptor für uuid oder eine ungültige QLowEnergyDescriptor Instanz zurück.

Siehe auch descriptors().

QList<QLowEnergyDescriptor> QLowEnergyCharacteristic::descriptors() const

Gibt die Liste der Deskriptoren zurück, die zu diesem Merkmal gehören; andernfalls eine leere Liste.

Siehe auch descriptor().

bool QLowEnergyCharacteristic::isValid() const

Gibt true zurück, wenn das Objekt QLowEnergyCharacteristic gültig ist, andernfalls gibt es false zurück.

Ein ungültiges Merkmalsobjekt ist mit keinem Dienst verbunden (standardmäßig konstruiert) oder der zugehörige Dienst ist nicht mehr gültig, z. B. weil die Verbindung zum zugrunde liegenden Bluetooth Low Energy Gerät unterbrochen wurde. Sobald das Objekt ungültig ist, kann es nicht mehr gültig werden.

QString QLowEnergyCharacteristic::name() const

Gibt den menschenlesbaren Namen des Merkmals zurück.

Der Name basiert auf dem uuid() des Merkmals, das standardisiert sein muss. Die vollständige Liste der Merkmalstypen finden Sie unter Bluetooth.org Merkmale.

Die zurückgegebene Zeichenkette ist leer, wenn die uuid() unbekannt ist.

Siehe auch QBluetoothUuid::characteristicToString().

QLowEnergyCharacteristic::PropertyTypes QLowEnergyCharacteristic::properties() const

Gibt die Eigenschaften des Merkmals zurück.

Die Eigenschaften definieren die Zugriffsberechtigungen für das Merkmal.

QBluetoothUuid QLowEnergyCharacteristic::uuid() const

Gibt die UUID des Merkmals zurück, wenn isValid() true zurückgibt; andernfalls eine null UUID.

QByteArray QLowEnergyCharacteristic::value() const

Gibt den zwischengespeicherten Wert des Merkmals zurück.

Wenn die properties() des Merkmals das Schreiben neuer Werte erlaubt, kann der Wert mit QLowEnergyService::writeCharacteristic() aktualisiert werden.

Der Cache wird während des detail discovery des zugehörigen Dienstes, bei einem erfolgreichen read/write Vorgang oder bei Erhalt einer Aktualisierungsmeldung aktualisiert.

Die zurückgegebene QByteArray bleibt immer leer, wenn das Merkmal die read permission nicht hat. In solchen Fällen kann nur die QLowEnergyService::characteristicChanged() oder QLowEnergyService::characteristicWritten() Informationen über den Wert dieses Merkmals liefern.

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

Erstellt eine Kopie von other und ordnet sie diesem QLowEnergyCharacteristic Objekt zu. Die beiden Kopien teilen sich weiterhin dieselben Dienst- und Steuerungsdetails.