Sur cette page

QLowEnergyServiceData Class

La classe QLowEnergyServiceData sert à configurer les données de service GATT. En savoir plus...

En-tête : #include <QLowEnergyServiceData>
CMake : find_package(Qt6 REQUIRED COMPONENTS Bluetooth)
target_link_libraries(mytarget PRIVATE Qt6::Bluetooth)
qmake : QT += bluetooth

Types publics

enum ServiceType { ServiceTypePrimary, ServiceTypeSecondary }

Fonctions publiques

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)

Description détaillée

Un objet de cette classe fournit un service à ajouter à un serveur GATT via la méthode ` QLowEnergyController::addService()`.

Documentation sur les types membres

enum QLowEnergyServiceData::ServiceType

Le type de service au sens du GATT.

ConstanteValeurDescription
QLowEnergyServiceData::ServiceTypePrimary0x2800Le service est un service primaire.
QLowEnergyServiceData::ServiceTypeSecondary0x2801Le service est un service secondaire. Les services secondaires sont intégrés par d’autres services afin de mettre en œuvre certaines fonctionnalités de niveau supérieur.

Documentation des fonctions membres

QLowEnergyServiceData::QLowEnergyServiceData()

Crée un nouvel objet non valide de cette classe.

QLowEnergyServiceData::QLowEnergyServiceData(const QLowEnergyServiceData &other)

Crée un nouvel objet de cette classe qui est une copie de other.

[noexcept] QLowEnergyServiceData::~QLowEnergyServiceData()

Détruit cet objet.

void QLowEnergyServiceData::addCharacteristic(const QLowEnergyCharacteristicData &characteristic)

Ajoute « characteristic » à la liste des caractéristiques, si cette valeur est valide.

Voir également setCharacteristics().

void QLowEnergyServiceData::addIncludedService(QLowEnergyService *service)

Ajoute service à la liste des services inclus. L'objet service doit avoir été renvoyé par un appel à la méthode QLowEnergyController::addService. Cette contrainte permet d'éviter les inclusions circulaires (interdites par la spécification Bluetooth) et facilite également la prise en charge du cas d'utilisation consistant à inclure plusieurs services du même type.

Voir également setIncludedServices().

QList<QLowEnergyCharacteristicData> QLowEnergyServiceData::characteristics() const

Renvoie la liste des caractéristiques.

Voir aussi setCharacteristics().

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

Renvoie la liste des services inclus.

Voir aussi setIncludedServices().

bool QLowEnergyServiceData::isValid() const

Renvoie « true » si ce service possède un UUID non nul.

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

Définit la liste des caractéristiques sur characteristics. Seules les caractéristiques valides sont prises en compte.

Voir également characteristics() et addCharacteristic().

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

Définit la liste des services inclus sur services. Tous les objets de cette liste doivent provenir d'un appel à la fonction QLowEnergyController::addService.

Voir également includedServices() et addIncludedService().

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

Définit le type de ce service sur « type ».

Voir également type().

void QLowEnergyServiceData::setUuid(const QBluetoothUuid &uuid)

Définit l'UUID de ce service sur uuid.

Voir également uuid().

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

Permute cet objet avec other.

QLowEnergyServiceData::ServiceType QLowEnergyServiceData::type() const

Renvoie le type de ce service.

Voir également setType().

QBluetoothUuid QLowEnergyServiceData::uuid() const

Renvoie l'UUID de ce service.

Voir aussi setUuid().

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

Fait de cet objet une copie de other et renvoie la nouvelle valeur de cet objet.

Éléments non membres associés

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

Renvoie « true » si « a » et « b » ne sont pas égaux au niveau de leur état public ; sinon, renvoie « false ».

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

Renvoie « true » si « a » et « b » sont égales au niveau de leur état public ; sinon, renvoie « false ».

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