QLowEnergyConnectionParameters Class
La classe QLowEnergyConnectionParameters est utilisée pour demander ou signaler une mise à jour des paramètres d'une connexion Bluetooth LE. Plus d'informations...
| En-tête : | #include <QLowEnergyConnectionParameters> |
| 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
- QLowEnergyConnectionParameters fait partie des classes implicitement partagées.
Fonctions publiques
| QLowEnergyConnectionParameters() | |
| QLowEnergyConnectionParameters(const QLowEnergyConnectionParameters &other) | |
| ~QLowEnergyConnectionParameters() | |
| int | latency() const |
| double | maximumInterval() const |
| double | minimumInterval() const |
| void | setIntervalRange(double minimum, double maximum) |
| void | setLatency(int latency) |
| void | setSupervisionTimeout(int timeout) |
| int | supervisionTimeout() const |
| void | swap(QLowEnergyConnectionParameters &other) |
| QLowEnergyConnectionParameters & | operator=(const QLowEnergyConnectionParameters &other) |
Non-membres associés
| bool | operator!=(const QLowEnergyConnectionParameters &p1, const QLowEnergyConnectionParameters &p2) |
| bool | operator==(const QLowEnergyConnectionParameters &p1, const QLowEnergyConnectionParameters &p2) |
Description détaillée
Les paramètres de connexion influencent la fréquence de synchronisation entre un appareil maître et un appareil esclave. En général, un intervalle de connexion et une latence plus faibles signifient une communication plus rapide, mais aussi une consommation d'énergie plus élevée. La manière dont ces critères doivent être pesés les uns par rapport aux autres dépend fortement du cas d'utilisation concret.
Android ne permet qu'indirectement d'ajuster cet ensemble de paramètres. La plateforme sépare les paramètres de connexion en trois catégories (priorité élevée, faible et équilibrée). Chaque catégorie implique un ensemble prédéfini de valeurs pour minimumInterval(), maximumInterval() et latency(). En outre, les plages de valeurs de chaque catégorie peuvent varier d'un appareil Android à l'autre. Qt utilise le minimumInterval() pour déterminer la catégorie cible comme suit :
| minimumInterval() | Priorité Android |
|---|---|
| intervalle < 30 | CONNEXION_PRIORITÉ_HAUTE |
| 30 <= intervalle <= 100 | CONNEXION_PRIORITÉ_ÉQUILIBRÉE |
| intervalle > 100 | CONNEXION_PRIORITÉ_FAIBLE_PUISSANCE |
L'adresse supervisionTimeout() ne peut pas être modifiée sur Android et est donc ignorée.
Voir également QLowEnergyController::requestConnectionUpdate et QLowEnergyController::connectionUpdated.
Documentation des fonctions membres
QLowEnergyConnectionParameters::QLowEnergyConnectionParameters()
Construit un nouvel objet de cette classe. Toutes les valeurs sont initialisées à des valeurs par défaut valides.
QLowEnergyConnectionParameters::QLowEnergyConnectionParameters(const QLowEnergyConnectionParameters &other)
Construit un nouvel objet de cette classe qui est une copie de other.
[noexcept] QLowEnergyConnectionParameters::~QLowEnergyConnectionParameters()
Détruit cet objet.
int QLowEnergyConnectionParameters::latency() const
Renvoie la latence esclave de la connexion.
Voir aussi setLatency().
double QLowEnergyConnectionParameters::maximumInterval() const
Renvoie l'intervalle de connexion maximal en millisecondes. La valeur par défaut est 4000.
Remarque : si cet objet a été émis via QLowEnergyController::connectionUpdated(), cette valeur est identique à celle de minimumInterval() et correspond à l'intervalle de connexion réel.
Voir aussi setIntervalRange().
double QLowEnergyConnectionParameters::minimumInterval() const
Renvoie l'intervalle minimum de connexion en millisecondes. La valeur par défaut est 7,5.
Remarque : si cet objet a été émis via QLowEnergyController::connectionUpdated(), cette valeur est la même que celle de maximumInterval() et fait référence à l'intervalle de connexion réel.
Voir également setIntervalRange().
void QLowEnergyConnectionParameters::setIntervalRange(double minimum, double maximum)
Définit la plage dans laquelle l'intervalle de connexion doit se situer. La valeur réelle sera déterminée par le contrôleur. minimum et maximum sont tous deux exprimés en millisecondes. Si maximum est plus petit que minimum, il sera fixé à la valeur de minimum. L'intervalle de connexion le plus petit possible est de 7,5 millisecondes, le plus grand de 4000 millisecondes.
Voir aussi minimumInterval() et maximumInterval().
void QLowEnergyConnectionParameters::setLatency(int latency)
Définit la latence esclave de la connexion (c'est-à-dire le nombre d'événements de connexion qu'un périphérique esclave est autorisé à ignorer) à latency. La valeur minimale est 0, la valeur maximale est 499.
Voir également latency().
void QLowEnergyConnectionParameters::setSupervisionTimeout(int timeout)
Fixe le délai de supervision du lien à timeout millisecondes. Cette valeur est soumise à plusieurs contraintes : Elle doit être comprise dans l'intervalle [100,32000] et doit être supérieure à (1 + latency()) * 2 * maximumInterval().
Sur Android, ce délai n'est pas réglable et est donc ignoré.
Voir également supervisionTimeout().
int QLowEnergyConnectionParameters::supervisionTimeout() const
Renvoie le délai de supervision de la connexion en millisecondes.
Voir aussi setSupervisionTimeout().
[noexcept] void QLowEnergyConnectionParameters::swap(QLowEnergyConnectionParameters &other)
Remplace cet objet par other.
QLowEnergyConnectionParameters &QLowEnergyConnectionParameters::operator=(const QLowEnergyConnectionParameters &other)
Fait de cet objet une copie de other et renvoie la nouvelle valeur de cet objet.
Non-membres apparentés
bool operator!=(const QLowEnergyConnectionParameters &p1, const QLowEnergyConnectionParameters &p2)
Renvoie true si p1 et p2 ne sont pas égaux en ce qui concerne leur état public, sinon renvoie false.
bool operator==(const QLowEnergyConnectionParameters &p1, const QLowEnergyConnectionParameters &p2)
Renvoie true si p1 et p2 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.
