QLowEnergyConnectionParameters Class
Die Klasse „QLowEnergyConnectionParameters“ wird verwendet, wenn eine Aktualisierung der Parameter einer Bluetooth-LE-Verbindung angefordert oder gemeldet wird. Mehr...
| Header: | #include <QLowEnergyConnectionParameters> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Bluetooth) target_link_libraries(mytarget PRIVATE Qt6::Bluetooth) |
| qmake: | QT += bluetooth |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QLowEnergyConnectionParameters gehört zu den implizit gemeinsam genutzten Klassen.
Öffentliche Funktionen
| 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) |
Verwandte Nicht-Mitglieder
| bool | operator!=(const QLowEnergyConnectionParameters &p1, const QLowEnergyConnectionParameters &p2) |
| bool | operator==(const QLowEnergyConnectionParameters &p1, const QLowEnergyConnectionParameters &p2) |
Detaillierte Beschreibung
Die Verbindungsparameter beeinflussen, wie oft sich ein Master- und ein Slave-Gerät miteinander synchronisieren. Im Allgemeinen bedeuten ein kürzeres Verbindungsintervall und eine geringere Latenz eine schnellere Kommunikation, aber auch einen höheren Stromverbrauch. Wie diese Kriterien gegeneinander abgewogen werden sollten, hängt stark vom konkreten Anwendungsfall ab.
Android erlaubt die Anpassung dieses Parametersatzes nur indirekt. Die Plattform unterteilt die Verbindungsparameter in drei Kategorien (hohe, niedrige und ausgewogene Priorität). Jede Kategorie impliziert einen vordefinierten Wertebereich für „ minimumInterval()“, „ maximumInterval()“ und „ latency()“. Zudem können die Wertebereiche der einzelnen Kategorien von einem Android-Gerät zum anderen variieren. Qt verwendet die Funktion „ minimumInterval()“, um die Zielkategorie wie folgt zu ermitteln:
| minimumInterval() | Android-Priorität |
|---|---|
| Intervall < 30 | CONNECTION_PRIORITY_HIGH |
| 30 <= Intervall <= 100 | CONNECTION_PRIORITY_BALANCED |
| Intervall > 100 | CONNECTION_PRIORITY_LOW_POWER |
Der Wert für ` supervisionTimeout()` kann unter Android nicht geändert werden und wird daher ignoriert.
Siehe auch „ QLowEnergyController::requestConnectionUpdate “ und „ QLowEnergyController::connectionUpdated “.
Dokumentation der Mitgliedsfunktionen
QLowEnergyConnectionParameters::QLowEnergyConnectionParameters()
Erstellt ein neues Objekt dieser Klasse. Alle Werte werden auf gültige Standardwerte initialisiert.
QLowEnergyConnectionParameters::QLowEnergyConnectionParameters(const QLowEnergyConnectionParameters &other)
Erstellt ein neues Objekt dieser Klasse, das eine Kopie von ` other` ist.
[noexcept] QLowEnergyConnectionParameters::~QLowEnergyConnectionParameters()
Zerstört dieses Objekt.
int QLowEnergyConnectionParameters::latency() const
Gibt die Slave-Latenz der Verbindung zurück.
Siehe auch ` setLatency()`.
double QLowEnergyConnectionParameters::maximumInterval() const
Gibt das maximale Verbindungsintervall in Millisekunden zurück. Der Standardwert beträgt 4000.
Hinweis: Wenn dieses Objekt über ` QLowEnergyController::connectionUpdated()` ausgegeben wurde, entspricht dieser Wert dem von ` minimumInterval()` und bezieht sich auf das tatsächliche Verbindungsintervall.
Siehe auch ` setIntervalRange()`.
double QLowEnergyConnectionParameters::minimumInterval() const
Gibt das minimale Verbindungsintervall in Millisekunden zurück. Der Standardwert beträgt 7,5.
Hinweis: Wenn dieses Objekt über ` QLowEnergyController::connectionUpdated()` ausgegeben wurde, entspricht dieser Wert dem Wert von ` maximumInterval()` und bezieht sich auf das tatsächliche Verbindungsintervall.
Siehe auch ` setIntervalRange()`.
void QLowEnergyConnectionParameters::setIntervalRange(double minimum, double maximum)
Legt den Bereich fest, in dem das Verbindungsintervall liegen soll. Der tatsächliche Wert wird vom Controller festgelegt. Sowohl „ minimum “ als auch „ maximum “ werden in Millisekunden angegeben. Ist „ maximum “ kleiner als „ minimum “, wird der Wert auf „ minimum “ gesetzt. Das kleinstmögliche Verbindungsintervall beträgt 7,5 Millisekunden, das größtmögliche 4000 Millisekunden.
Siehe auch minimumInterval() und maximumInterval().
void QLowEnergyConnectionParameters::setLatency(int latency)
Setzt die Slave-Latenz der Verbindung (d. h. die Anzahl der Verbindungsereignisse, die ein Slave-Gerät ignorieren darf) auf latency. Der Mindestwert beträgt 0, der Höchstwert 499.
Siehe auch ` latency()`.
void QLowEnergyConnectionParameters::setSupervisionTimeout(int timeout)
Legt das Zeitlimit für die Verbindungsüberwachung auf timeout Millisekunden fest. Für diesen Wert gelten mehrere Einschränkungen: Er muss im Bereich [100, 32000] liegen und größer sein als (1 + latency()) * 2 * maximumInterval().
Unter Android ist dieses Zeitlimit nicht einstellbar und wird daher ignoriert.
Siehe auch supervisionTimeout().
int QLowEnergyConnectionParameters::supervisionTimeout() const
Gibt das Timeout für die Verbindungsüberwachung in Millisekunden zurück.
Siehe auch ` setSupervisionTimeout()`.
[noexcept] void QLowEnergyConnectionParameters::swap(QLowEnergyConnectionParameters &other)
Tauscht dieses Objekt mit „ other “ aus.
QLowEnergyConnectionParameters &QLowEnergyConnectionParameters::operator=(const QLowEnergyConnectionParameters &other)
Erstellt eine Kopie von „ other “ und gibt den neuen Wert dieses Objekts zurück.
Verwandte Nicht-Mitglieder
bool operator!=(const QLowEnergyConnectionParameters &p1, const QLowEnergyConnectionParameters &p2)
Gibt „ true “ zurück, wenn „ p1 “ und „ p2 “ hinsichtlich ihres öffentlichen Zustands nicht gleich sind; andernfalls wird „ false “ zurückgegeben.
bool operator==(const QLowEnergyConnectionParameters &p1, const QLowEnergyConnectionParameters &p2)
Gibt „ true “ zurück, wenn „ p1 “ und „ p2 “ hinsichtlich ihres öffentlichen Zustands gleich sind; andernfalls wird „ false “ zurückgegeben.
© 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.
