Auf dieser Seite

QLowEnergyServiceData Class

Die Klasse „QLowEnergyServiceData“ dient zur Einrichtung von GATT-Dienstdaten. Mehr dazu...

Header: #include <QLowEnergyServiceData>
CMake: find_package(Qt6 REQUIRED COMPONENTS Bluetooth)
target_link_libraries(mytarget PRIVATE Qt6::Bluetooth)
qmake: QT += bluetooth

Öffentliche Typen

enum ServiceType { ServiceTypePrimary, ServiceTypeSecondary }

Öffentliche Funktionen

QLowEnergyServiceData()
QLowEnergyServiceData(const QLowEnergyServiceData &other)
~QLowEnergyServiceData()
void addCharacteristic(const QLowEnergyCharacteristicData &characteristic)
void addIncludedService(QLowEnergyService *service)
QList<QLowEnergyCharacteristicData> characteristics() const
QList<QLowEnergyService *> includedServices() const
bool isValid() const
void setCharacteristics(const QList<QLowEnergyCharacteristicData> &characteristics)
void setIncludedServices(const QList<QLowEnergyService *> &services)
void setType(QLowEnergyServiceData::ServiceType type)
void setUuid(const QBluetoothUuid &uuid)
void swap(QLowEnergyServiceData &other)
QLowEnergyServiceData::ServiceType type() const
QBluetoothUuid uuid() const
QLowEnergyServiceData &operator=(const QLowEnergyServiceData &other)
bool operator!=(const QLowEnergyServiceData &a, const QLowEnergyServiceData &b)
bool operator==(const QLowEnergyServiceData &a, const QLowEnergyServiceData &b)

Ausführliche Beschreibung

Ein Objekt dieser Klasse stellt einen Dienst bereit, der über ` QLowEnergyController::addService()` zu einem GATT-Server hinzugefügt werden kann.

Dokumentation zu den Mitgliedstypen

enum QLowEnergyServiceData::ServiceType

Die Art der GATT-Dienstleistung.

KonstanteWertBeschreibung
QLowEnergyServiceData::ServiceTypePrimary0x2800Die Dienstleistung ist eine Primärdienstleistung.
QLowEnergyServiceData::ServiceTypeSecondary0x2801Der Dienst ist ein sekundärer Dienst. Sekundäre Dienste werden von anderen Diensten eingebunden, um Funktionen auf höherer Ebene zu implementieren.

Dokumentation der Member-Funktionen

QLowEnergyServiceData::QLowEnergyServiceData()

Erstellt ein neues ungültiges Objekt dieser Klasse.

QLowEnergyServiceData::QLowEnergyServiceData(const QLowEnergyServiceData &other)

Erstellt ein neues Objekt dieser Klasse, das eine Kopie von ` other` ist.

[noexcept] QLowEnergyServiceData::~QLowEnergyServiceData()

Zerstört dieses Objekt.

void QLowEnergyServiceData::addCharacteristic(const QLowEnergyCharacteristicData &characteristic)

Fügt „ characteristic “ zur Liste der Merkmale hinzu, sofern es gültig ist.

Siehe auch setCharacteristics().

void QLowEnergyServiceData::addIncludedService(QLowEnergyService *service)

Fügt „ service “ zur Liste der einbezogenen Dienste hinzu. Das Objekt „ service “ muss von einem Aufruf von „ QLowEnergyController::addService “ zurückgegeben worden sein. Diese Anforderung verhindert zirkuläre Einbindungen (die gemäß der Bluetooth-Spezifikation verboten sind) und unterstützt zudem den Anwendungsfall, bei dem mehr als ein Dienst desselben Typs einbezogen wird.

Siehe auch ` setIncludedServices()`.

QList<QLowEnergyCharacteristicData> QLowEnergyServiceData::characteristics() const

Gibt die Liste der Merkmale zurück.

Siehe auch „ setCharacteristics()“.

QList<QLowEnergyService *> QLowEnergyServiceData::includedServices() const

Gibt die Liste der enthaltenen Dienste zurück.

Siehe auch setIncludedServices().

bool QLowEnergyServiceData::isValid() const

Gibt „ true “ zurück, wenn dieser Dienst eine von null verschiedene UUID besitzt.

void QLowEnergyServiceData::setCharacteristics(const QList<QLowEnergyCharacteristicData> &characteristics)

Setzt die Liste der Merkmale auf „ characteristics “. Es werden nur gültige Merkmale berücksichtigt.

Siehe auch „ characteristics()“ und „ addCharacteristic()“.

void QLowEnergyServiceData::setIncludedServices(const QList<QLowEnergyService *> &services)

Legt die Liste der enthaltenen Dienste auf „ services “ fest. Alle Objekte in dieser Liste müssen durch einen Aufruf von „ QLowEnergyController::addService “ zurückgegeben worden sein.

Siehe auch includedServices() und addIncludedService().

void QLowEnergyServiceData::setType(QLowEnergyServiceData::ServiceType type)

Legt den Typ dieses Dienstes auf „ type “ fest.

Siehe auch type().

void QLowEnergyServiceData::setUuid(const QBluetoothUuid &uuid)

Setzt die UUID dieses Dienstes auf uuid.

Siehe auch uuid().

[noexcept] void QLowEnergyServiceData::swap(QLowEnergyServiceData &other)

Tauscht dieses Objekt mit „ other “ aus.

QLowEnergyServiceData::ServiceType QLowEnergyServiceData::type() const

Gibt den Typ dieses Dienstes zurück.

Siehe auch setType().

QBluetoothUuid QLowEnergyServiceData::uuid() const

Gibt die UUID dieses Dienstes zurück.

Siehe auch „ setUuid()“.

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

Erstellt eine Kopie von „ other “ und gibt den neuen Wert dieses Objekts zurück.

Verwandte Nicht-Mitglieder

bool operator!=(const QLowEnergyServiceData &a, const QLowEnergyServiceData &b)

Gibt „ true “ zurück, wenn „ a “ und „ b “ hinsichtlich ihres öffentlichen Zustands ungleich sind; andernfalls wird „ false “ zurückgegeben.

bool operator==(const QLowEnergyServiceData &a, const QLowEnergyServiceData &b)

Gibt „ true “ zurück, wenn „ a “ und „ b “ hinsichtlich ihres öffentlichen Zustands gleich sind, andernfalls wird „ false “ zurückgegeben.

© 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.