QLowEnergyAdvertisingParameters Class
La classe `QLowEnergyAdvertisingParameters` représente les paramètres utilisés pour la diffusion d'informations via Bluetooth Low Energy. En savoir plus...
| 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 des classes partagées implicitement.
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) |
Éléments non membres associé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 diffusion, plusieurs paramètres peuvent être configurés, tels que la vitesse de diffusion ou les clients autorisés à se connecter au périphérique émetteur, le cas échéant. Ces paramètres sont définis via cette classe, et leurs valeurs seront utilisées lorsque la diffusion sera lancée par l'appel de la fonction QLowEnergyController::startAdvertising().
Voir également QLowEnergyAdvertisingData et QLowEnergyController::startAdvertising().
Documentation sur les types de membres
enum QLowEnergyAdvertisingParameters::FilterPolicy
Définit la sémantique de la liste blanche.
| Constante | Valeur | Description |
|---|---|---|
QLowEnergyAdvertisingParameters::IgnoreWhiteList | 0x00 | La valeur de la liste blanche est ignorée ; en d'autres termes, aucun filtrage n'est appliqué aux requêtes de balayage ou de connexion lors de l'utilisation de la diffusion non dirigée. |
QLowEnergyAdvertisingParameters::UseWhiteListForScanning | 0x01 | La liste blanche est utilisée lors du traitement des requêtes de scan, mais elle est ignorée pour les requêtes 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 d'analyse. |
QLowEnergyAdvertisingParameters::UseWhiteListForScanningAndConnecting | 0x03 | La liste blanche est utilisée à la fois pour les requêtes de connexion et les requêtes de scan. |
Voir également QLowEnergyAdvertisingParameters::whiteList().
enum QLowEnergyAdvertisingParameters::Mode
Précise la manière dont la publicité doit être diffusée.
| Constante | Valeur | Description |
|---|---|---|
QLowEnergyAdvertisingParameters::AdvInd | 0x0 | Pour une publicité non ciblée et connectable. La publicité n’est pas destinée à un appareil spécifique et un appareil qui voit la publicité peut se connecter à l’appareil émetteur ou envoyer des demandes de scan. |
QLowEnergyAdvertisingParameters::AdvScanInd | 0x2 | Pour une publicité non ciblée et pouvant faire l'objet d'une recherche. La publicité n'est pas destinée à un appareil spécifique et un appareil qui la détecte peut envoyer une requête de recherche à l'appareil émetteur, mais ne peut pas s'y connecter. |
QLowEnergyAdvertisingParameters::AdvNonConnInd | 0x3 | Pour la publicité non ciblée et non connectable. La publicité n’est pas destinée à un appareil spécifique. Un appareil qui voit la publicité ne peut ni se connecter à l’appareil publicitaire, ni envoyer de requête de scan. Ce mode implique donc une simple diffusion. |
Documentation des fonctions membres
QLowEnergyAdvertisingParameters::QLowEnergyAdvertisingParameters()
Crée 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)
Crée 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 la manière dont la liste blanche est utilisée. La valeur par défaut est « QLowEnergyAdvertisingParameters::IgnoreWhiteList ».
int QLowEnergyAdvertisingParameters::maximumInterval() const
Renvoie la durée maximale d'une publicité en millisecondes. La valeur par défaut est 1 280.
int QLowEnergyAdvertisingParameters::minimumInterval() const
Renvoie l'intervalle publicitaire minimal en millisecondes. La valeur par défaut est 1 280.
QLowEnergyAdvertisingParameters::Mode QLowEnergyAdvertisingParameters::mode() const
Renvoie le mode publicitaire. La valeur par défaut est « QLowEnergyAdvertisingParameters::AdvInd ».
Voir aussi setMode().
void QLowEnergyAdvertisingParameters::setInterval(quint16 minimum, quint16 maximum)
Définit l'intervalle de diffusion. Il s'agit d'une plage qui fournit au contrôleur une limite supérieure et une limite inférieure concernant la fréquence d'envoi des données de diffusion. Les valeurs « minimum » et « maximum » sont toutes deux exprimées en millisecondes. Si « maximum » est inférieur à « minimum », la valeur sera définie sur « minimum ».
Remarque : 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 élevée possible sera utilisée, respectivement.
La configuration de l’intervalle de diffusion est prise en charge par le backend DBus de BlueZ 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 publicitaire sur « mode ».
Voir aussi mode().
void QLowEnergyAdvertisingParameters::setWhiteList(const QList<QLowEnergyAdvertisingParameters::AddressInfo> &whiteList, QLowEnergyAdvertisingParameters::FilterPolicy policy)
Définit la liste blanche susceptible d’être utilisée pour filtrer les requêtes de balayage et de connexion. Le paramètre « whiteList » correspond à la liste des adresses à utiliser pour le filtrage, tandis que « policy » précise comment utiliser exactement whiteList.
Les listes blanches ne sont pas prises en charge par le backend DBus de BlueZ, car elles ne sont pas prises en charge par BlueZ.
Voir également whiteList().
[noexcept] void QLowEnergyAdvertisingParameters::swap(QLowEnergyAdvertisingParameters &other)
Permute cet objet avec other.
QList<QLowEnergyAdvertisingParameters::AddressInfo> QLowEnergyAdvertisingParameters::whiteList() const
Renvoie la liste blanche utilisée pour filtrer les requêtes 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.
Éléments non membres associés
bool operator!=(const QLowEnergyAdvertisingParameters &a, const QLowEnergyAdvertisingParameters &b)
Renvoie « true » si « a » et « b » ne sont pas égaux au niveau de leur état public ; sinon, renvoie « false ».
bool operator==(const QLowEnergyAdvertisingParameters &a, const QLowEnergyAdvertisingParameters &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.
