QLowEnergyCharacteristic Class

Dokumentation der Mitgliedsfunktionen

QLowEnergyCharacteristic::QLowEnergyCharacteristic()

Erstellen Sie ein neues `QLowEnergyCharacteristic`. Eine mit der Standardkonstruktion erstellte Instanz dieser Klasse ist immer ungültig.

Siehe auch „ isValid()“.

QLowEnergyCharacteristic::QLowEnergyCharacteristic(const QLowEnergyCharacteristic &other)

Erstellen Sie ein neues `QLowEnergyCharacteristic`, das eine Kopie von ` other` ist.

Die beiden Kopien nutzen weiterhin dieselben zugrunde liegenden Daten, die beim Schreiben nicht getrennt werden.

[noexcept] QLowEnergyCharacteristic::~QLowEnergyCharacteristic()

Löscht das „ QLowEnergyCharacteristic “-Objekt.

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

Gibt den Client-Merkmalskonfigurationsdeskriptor zurück oder eine ungültige Instanz von „ QLowEnergyDescriptor “, falls kein Client-Merkmalskonfigurationsdeskriptor vorhanden ist.

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

Wenn ein Merkmal Benachrichtigungen oder Anzeigen unterstützt, können diese aktiviert werden, indem spezielle Bitmuster in den Client-Merkmalskonfigurationsdeskriptor geschrieben werden. Der Einfachheit halber werden diese Bitmuster als „ QLowEnergyCharacteristic::CCCDDisable “, „ QLowEnergyCharacteristic::CCCDEnableNotification “ und „ QLowEnergyCharacteristic::CCCDEnableIndication “ bereitgestellt.

Das Aktivieren beispielsweise der Benachrichtigung für ein Merkmal namens „ mycharacteristic “ in einem Dienst namens „ myservice “ könnte 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 Instanz von „ QLowEnergyDescriptor “ zurück.

Siehe auch descriptors().

QList<QLowEnergyDescriptor> QLowEnergyCharacteristic::descriptors() const

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

Siehe auch „ descriptor()“.

bool QLowEnergyCharacteristic::isValid() const

Gibt „ true “ zurück, wenn das „ QLowEnergyCharacteristic “-Objekt gültig ist, andernfalls „ false “.

Ein ungültiges Merkmalobjekt ist keinem Dienst zugeordnet (Standardkonstruktion) oder der zugehörige Dienst ist nicht mehr gültig, beispielsweise aufgrund einer Unterbrechung der Verbindung zum zugrunde liegenden Bluetooth Low Energy-Gerät. Sobald das Objekt ungültig ist, kann es nicht mehr gültig werden.

QString QLowEnergyCharacteristic::name() const

Gibt den für Menschen lesbaren 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 Characteristics“.

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

Siehe auch ` QBluetoothUuid::characteristicToString()`.

QLowEnergyCharacteristic::PropertyTypes QLowEnergyCharacteristic::properties() const

Gibt die Eigenschaften des Merkmals zurück.

Die Eigenschaften legen die Zugriffsberechtigungen für das Merkmal fest.

QBluetoothUuid QLowEnergyCharacteristic::uuid() const

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

QByteArray QLowEnergyCharacteristic::value() const

Gibt den zwischengespeicherten Wert des Merkmals zurück.

Wenn die Methode „ properties()“ des Merkmals das Schreiben neuer Werte zulässt, kann der Wert mit „ QLowEnergyService::writeCharacteristic()“ aktualisiert werden.

Der Cache wird während des „ detail discovery “ des zugehörigen Dienstes, bei einer erfolgreichen „ read “-/„write “-Operation oder beim Empfang einer Aktualisierungsbenachrichtigung aktualisiert.

Der zurückgegebene Wert von ` QByteArray ` bleibt immer leer, wenn das Merkmal keine ` read permission` aufweist. In solchen Fällen können nur die Methoden ` QLowEnergyService::characteristicChanged()` oder ` QLowEnergyService::characteristicWritten()` Informationen über den Wert dieses Merkmals liefern.

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

Erstellt eine Kopie von „ other “ und weist sie diesem „ QLowEnergyCharacteristic “-Objekt zu. Die beiden Kopien nutzen weiterhin dieselben Service- und Controller-Details.