QLowEnergyAdvertisingParameters Class
La classe QLowEnergyAdvertisingParameters représente les paramètres utilisés pour la publicité Bluetooth Low Energy. Plus d'informations...
| En-tête : | #include <QLowEnergyAdvertisingParameters> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Bluetooth)target_link_libraries(mytarget PRIVATE Qt6::Bluetooth) |
| qmake : | QT += bluetooth |
- Liste de tous les membres, y compris les membres hérités
- QLowEnergyAdvertisingParameters fait partie de Implicitly Shared Classes.
Types publics
| class | AddressInfo |
| enum | FilterPolicy { IgnoreWhiteList, UseWhiteListForScanning, UseWhiteListForConnecting, UseWhiteListForScanningAndConnecting } |
| enum | Mode { AdvInd, AdvScanInd, AdvNonConnInd } |
Fonctions publiques
| QLowEnergyAdvertisingParameters() | |
| QLowEnergyAdvertisingParameters(const QLowEnergyAdvertisingParameters &other) | |
| ~QLowEnergyAdvertisingParameters() | |
| QLowEnergyAdvertisingParameters::FilterPolicy | filterPolicy() const |
| int | maximumInterval() const |
| int | minimumInterval() const |
| QLowEnergyAdvertisingParameters::Mode | mode() const |
| void | setInterval(quint16 minimum, quint16 maximum) |
| void | setMode(QLowEnergyAdvertisingParameters::Mode mode) |
| void | setWhiteList(const QList<QLowEnergyAdvertisingParameters::AddressInfo> &whiteList, QLowEnergyAdvertisingParameters::FilterPolicy policy) |
| void | swap(QLowEnergyAdvertisingParameters &other) |
| QList<QLowEnergyAdvertisingParameters::AddressInfo> | whiteList() const |
| QLowEnergyAdvertisingParameters & | operator=(const QLowEnergyAdvertisingParameters &other) |
Non-membres apparentés
| bool | operator!=(const QLowEnergyAdvertisingParameters &a, const QLowEnergyAdvertisingParameters &b) |
| bool | operator==(const QLowEnergyAdvertisingParameters &a, const QLowEnergyAdvertisingParameters &b) |
Description détaillée
Lors de l'exécution de la procédure de publicité, un certain nombre de paramètres peuvent être configurés, tels que la vitesse de diffusion de la publicité ou les clients qui peuvent éventuellement se connecter au dispositif de publicité. Ces paramètres sont définis par l'intermédiaire de cette classe et leurs valeurs seront utilisées lorsque la publicité sera lancée en appelant QLowEnergyController::startAdvertising().
Voir également QLowEnergyAdvertisingData et QLowEnergyController::startAdvertising().
Documentation sur les types de membres
enum QLowEnergyAdvertisingParameters::FilterPolicy
Spécifie la sémantique de la liste blanche.
| Constante | Valeur | Description de la valeur de la liste blanche |
|---|---|---|
QLowEnergyAdvertisingParameters::IgnoreWhiteList | 0x00 | La valeur de la liste blanche est ignorée, c'est-à-dire qu'aucun filtrage n'a lieu pour les demandes de balayage ou de connexion lors de l'utilisation de la publicité non dirigée. |
QLowEnergyAdvertisingParameters::UseWhiteListForScanning | 0x01 | La liste blanche est utilisée lors du traitement des demandes de balayage, mais est ignorée pour les demandes de connexion. |
QLowEnergyAdvertisingParameters::UseWhiteListForConnecting | 0x02 | La liste blanche est utilisée lors du traitement des demandes de connexion, mais est ignorée pour les demandes de balayage. |
QLowEnergyAdvertisingParameters::UseWhiteListForScanningAndConnecting | 0x03 | La liste blanche est utilisée à la fois pour les demandes de connexion et de balayage. |
Voir également QLowEnergyAdvertisingParameters::whiteList().
enum QLowEnergyAdvertisingParameters::Mode
Spécifie la manière dont la publicité doit être faite.
| Constante | Valeur | Description |
|---|---|---|
QLowEnergyAdvertisingParameters::AdvInd | 0x0 | Pour la publicité non dirigée, connectable. La publicité n'est pas dirigée vers un dispositif spécifique et un dispositif qui voit la publicité peut se connecter au dispositif publicitaire ou envoyer des demandes de balayage. |
QLowEnergyAdvertisingParameters::AdvScanInd | 0x2 | Pour les publicités non dirigées, pouvant être scannées. La publicité n'est pas dirigée vers un dispositif spécifique et un dispositif qui voit la publicité peut envoyer une demande de balayage au dispositif publicitaire, mais ne peut pas s'y connecter. |
QLowEnergyAdvertisingParameters::AdvNonConnInd | 0x3 | Pour la publicité non dirigée et non connectable. La publicité n'est pas dirigée vers un dispositif spécifique. Un appareil qui voit la publicité ne peut pas se connecter à l'appareil qui fait la publicité, ni envoyer une demande de balayage. Ce mode implique donc une diffusion pure. |
Documentation des fonctions membres
QLowEnergyAdvertisingParameters::QLowEnergyAdvertisingParameters()
Construit un nouvel objet de cette classe. Toutes les valeurs sont initialisées à leurs valeurs par défaut conformément à la spécification Bluetooth Low Energy.
QLowEnergyAdvertisingParameters::QLowEnergyAdvertisingParameters(const QLowEnergyAdvertisingParameters &other)
Construit un nouvel objet de cette classe qui est une copie de other.
[noexcept] QLowEnergyAdvertisingParameters::~QLowEnergyAdvertisingParameters()
Détruit cet objet.
QLowEnergyAdvertisingParameters::FilterPolicy QLowEnergyAdvertisingParameters::filterPolicy() const
Renvoie la politique de filtrage qui détermine comment la liste blanche est utilisée. La valeur par défaut est QLowEnergyAdvertisingParameters::IgnoreWhiteList.
int QLowEnergyAdvertisingParameters::maximumInterval() const
Renvoie l'intervalle de publicité maximal en millisecondes. La valeur par défaut est 1280.
int QLowEnergyAdvertisingParameters::minimumInterval() const
Renvoie l'intervalle minimal de publicité en millisecondes. La valeur par défaut est 1280.
QLowEnergyAdvertisingParameters::Mode QLowEnergyAdvertisingParameters::mode() const
Renvoie le mode de publicité. La valeur par défaut est QLowEnergyAdvertisingParameters::AdvInd.
Voir aussi setMode().
void QLowEnergyAdvertisingParameters::setInterval(quint16 minimum, quint16 maximum)
Définit l'intervalle de publicité. Il s'agit d'une fourchette qui donne au contrôleur une limite supérieure et une limite inférieure pour la fréquence d'envoi des données publicitaires. Les valeurs de minimum et maximum sont exprimées en millisecondes. Si maximum est plus petit que minimum, il sera fixé à la valeur de minimum.
Note : Il existe des limites pour l'intervalle minimum et maximum ; les valeurs exactes dépendent du mode. Si elles sont dépassées, la valeur la plus basse ou la plus haute possible sera utilisée, respectivement.
La définition de l'intervalle de publicité est prise en charge par le backend BlueZ DBus si son statut expérimental est modifié dans les versions ultérieures de BlueZ (ou s'il est exécuté en mode expérimental).
void QLowEnergyAdvertisingParameters::setMode(QLowEnergyAdvertisingParameters::Mode mode)
Définit le mode de publicité sur mode.
Voir aussi mode().
void QLowEnergyAdvertisingParameters::setWhiteList(const QList<QLowEnergyAdvertisingParameters::AddressInfo> &whiteList, QLowEnergyAdvertisingParameters::FilterPolicy policy)
Définit la liste blanche potentiellement utilisée pour filtrer les demandes d'analyse et de connexion. Le paramètre whiteList est la liste des adresses à utiliser pour le filtrage, et policy spécifie comment utiliser exactement whiteList.
Les listes blanches ne sont pas supportées par le backend BlueZ DBus car elles ne sont pas supportées par BlueZ.
Voir aussi whiteList().
[noexcept] void QLowEnergyAdvertisingParameters::swap(QLowEnergyAdvertisingParameters &other)
Remplace cet objet par other.
QList<QLowEnergyAdvertisingParameters::AddressInfo> QLowEnergyAdvertisingParameters::whiteList() const
Renvoie la liste blanche utilisée pour filtrer les demandes d'analyse et de connexion. Par défaut, cette liste est vide.
Voir aussi setWhiteList().
QLowEnergyAdvertisingParameters &QLowEnergyAdvertisingParameters::operator=(const QLowEnergyAdvertisingParameters &other)
Fait de cet objet une copie de other et renvoie la nouvelle valeur de cet objet.
Non-membres apparentés
bool operator!=(const QLowEnergyAdvertisingParameters &a, const QLowEnergyAdvertisingParameters &b)
Renvoie true si a et b ne sont pas égaux en ce qui concerne leur état public, sinon renvoie false.
bool operator==(const QLowEnergyAdvertisingParameters &a, const QLowEnergyAdvertisingParameters &b)
Renvoie true si a et b sont égaux en ce qui concerne 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.
