QLowEnergyConnectionParameters Class
La classe `QLowEnergyConnectionParameters` est utilisée pour demander ou signaler une mise à jour des paramètres d'une connexion Bluetooth LE. En savoir plus...
| 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 partagées implicitement.
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) |
Éléments 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 à laquelle un périphérique maître et un périphérique esclave se synchronisent entre eux. En général, un intervalle de connexion et une latence plus faibles se traduisent par une communication plus rapide, mais également par une consommation d’énergie plus élevée. La manière dont ces critères doivent être mis en balance dépend fortement du cas d’utilisation concret.
Android n'autorise que de manière indirecte le réglage de cet ensemble de paramètres. La plateforme répartit 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 les fonctions minimumInterval(), maximumInterval() et latency(). De plus, les plages de valeurs de chaque catégorie peuvent varier d'un appareil Android à l'autre. Qt utilise la méthode ` minimumInterval()` pour déterminer la catégorie cible comme suit :
| minimumInterval() | Priorité Android |
|---|---|
| intervalle < 30 | CONNECTION_PRIORITY_HIGH |
| 30 <= intervalle <= 100 | CONNECTION_PRIORITY_BALANCED |
| intervalle > 100 | CONNECTION_PRIORITY_LOW_POWER |
La valeur de la fonction ` supervisionTimeout()` ne peut pas être modifiée sous Android et est donc ignorée.
Voir également QLowEnergyController::requestConnectionUpdate et QLowEnergyController::connectionUpdated.
Documentation des fonctions membres
QLowEnergyConnectionParameters::QLowEnergyConnectionParameters()
Crée un nouvel objet de cette classe. Toutes les valeurs sont initialisées à leurs valeurs par défaut valides.
QLowEnergyConnectionParameters::QLowEnergyConnectionParameters(const QLowEnergyConnectionParameters &other)
Crée 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 également 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é généré via la fonction ` QLowEnergyController::connectionUpdated()`, cette valeur est identique à celle de la fonction ` minimumInterval()` et correspond à l’intervalle de connexion réel.
Voir également setIntervalRange().
double QLowEnergyConnectionParameters::minimumInterval() const
Renvoie l'intervalle minimal entre deux connexions, en millisecondes. La valeur par défaut est 7,5.
Remarque : si cet objet a été émis via QLowEnergyController::connectionUpdated(), alors cette valeur est identique à celle de maximumInterval() et correspond à l'intervalle de connexion réel.
Voir également setIntervalRange().
void QLowEnergyConnectionParameters::setIntervalRange(double minimum, double maximum)
Définit la plage dans laquelle doit se situer l'intervalle de connexion. La valeur réelle sera déterminée par le contrôleur. Les paramètres minimum et maximum sont tous deux exprimés en millisecondes. Si maximum est inférieur à minimum, il sera défini sur la valeur de minimum. L'intervalle de connexion minimal est de 7,5 millisecondes, le maximal de 4 000 millisecondes.
Voir également 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) sur latency. La valeur minimale est 0, la valeur maximale est 499.
Voir également latency().
void QLowEnergyConnectionParameters::setSupervisionTimeout(int timeout)
Définit le délai d'expiration de la surveillance de la liaison à timeout millisecondes. Cette valeur est soumise à plusieurs contraintes : elle doit être comprise entre 100 et 32 000 et doit être supérieure à (1 + latency()) * 2 * maximumInterval().
Sous Android, ce délai d'expiration n'est pas modifiable et est donc ignoré.
Voir également supervisionTimeout().
int QLowEnergyConnectionParameters::supervisionTimeout() const
Renvoie le délai d'expiration de la supervision de la liaison de la connexion, en millisecondes.
Voir également setSupervisionTimeout().
[noexcept] void QLowEnergyConnectionParameters::swap(QLowEnergyConnectionParameters &other)
Permute cet objet avec other.
QLowEnergyConnectionParameters &QLowEnergyConnectionParameters::operator=(const QLowEnergyConnectionParameters &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 QLowEnergyConnectionParameters &p1, const QLowEnergyConnectionParameters &p2)
Renvoie « true » si « p1 » et « p2 » ne sont pas égaux au niveau de leur état public ; sinon, renvoie « false ».
bool operator==(const QLowEnergyConnectionParameters &p1, const QLowEnergyConnectionParameters &p2)
Renvoie ` true ` si ` p1 ` et ` p2 ` 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.
