QLowEnergyAdvertisingParameters Class
Die Klasse „QLowEnergyAdvertisingParameters“ repräsentiert die Parameter, die für die Bluetooth-Low-Energy-Advertising-Funktion verwendet werden. Mehr...
| Header: | #include <QLowEnergyAdvertisingParameters> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Bluetooth) target_link_libraries(mytarget PRIVATE Qt6::Bluetooth) |
| qmake: | QT += bluetooth |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QLowEnergyAdvertisingParameters gehört zu den implizit gemeinsam genutzten Klassen.
Öffentliche Typen
| class | AddressInfo |
| enum | FilterPolicy { IgnoreWhiteList, UseWhiteListForScanning, UseWhiteListForConnecting, UseWhiteListForScanningAndConnecting } |
| enum | Mode { AdvInd, AdvScanInd, AdvNonConnInd } |
Öffentliche Funktionen
| 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) |
Verwandte Nicht-Mitglieder
| bool | operator!=(const QLowEnergyAdvertisingParameters &a, const QLowEnergyAdvertisingParameters &b) |
| bool | operator==(const QLowEnergyAdvertisingParameters &a, const QLowEnergyAdvertisingParameters &b) |
Ausführliche Beschreibung
Bei der Ausführung der Advertising-Prozedur können verschiedene Parameter konfiguriert werden, z. B. die Geschwindigkeit der Advertising-Übertragung oder welche Clients sich gegebenenfalls mit dem Advertising-Gerät verbinden dürfen. Diese Parameter werden über diese Klasse festgelegt, und ihre Werte werden verwendet, wenn das Advertising durch den Aufruf von ` QLowEnergyController::startAdvertising()` gestartet wird.
Siehe auch ` QLowEnergyAdvertisingData ` und ` QLowEnergyController::startAdvertising()`.
Dokumentation zu Mitgliedstypen
enum QLowEnergyAdvertisingParameters::FilterPolicy
Legt die Semantik der Whitelist fest.
| Konstante | Wert | Beschreibung |
|---|---|---|
QLowEnergyAdvertisingParameters::IgnoreWhiteList | 0x00 | Der Wert der Whitelist wird ignoriert, d. h., bei der Verwendung von ungerichteter Werbung findet weder bei Scan- noch bei Verbindungsanfragen eine Filterung statt. |
QLowEnergyAdvertisingParameters::UseWhiteListForScanning | 0x01 | Die Whitelist wird bei der Bearbeitung von Scan-Anfragen verwendet, bei Verbindungsanfragen jedoch ignoriert. |
QLowEnergyAdvertisingParameters::UseWhiteListForConnecting | 0x02 | Die Whitelist wird bei der Bearbeitung von Verbindungsanfragen verwendet, bei Scan-Anfragen jedoch ignoriert. |
QLowEnergyAdvertisingParameters::UseWhiteListForScanningAndConnecting | 0x03 | Die Whitelist wird sowohl für Verbindungs- als auch für Scan-Anfragen verwendet. |
Siehe auch ` QLowEnergyAdvertisingParameters::whiteList()`.
enum QLowEnergyAdvertisingParameters::Mode
Legt fest, auf welche Weise Werbung geschaltet werden soll.
| Konstante | Wert | Beschreibung |
|---|---|---|
QLowEnergyAdvertisingParameters::AdvInd | 0x0 | Für nicht zielgerichtete, verbindbare Werbung. Die Werbung richtet sich nicht an ein bestimmtes Gerät, und ein Gerät, das die Werbung sieht, kann eine Verbindung zum werbenden Gerät herstellen oder Scan-Anfragen senden. |
QLowEnergyAdvertisingParameters::AdvScanInd | 0x2 | Für nicht zielgerichtete, scanbare Werbung. Die Werbung ist nicht an ein bestimmtes Gerät gerichtet, und ein Gerät, das die Werbung empfängt, kann eine Scan-Anfrage an das werbende Gerät senden, sich jedoch nicht mit diesem verbinden. |
QLowEnergyAdvertisingParameters::AdvNonConnInd | 0x3 | Für nicht zielgerichtete, nicht verbindbare Werbung. Die Werbung ist nicht auf ein bestimmtes Gerät ausgerichtet. Ein Gerät, das die Werbung sieht, kann weder eine Verbindung zum Werbegerät herstellen noch eine Scan-Anfrage senden. Dieser Modus entspricht somit einer reinen Ausstrahlung. |
Dokumentation der Mitgliedsfunktionen
QLowEnergyAdvertisingParameters::QLowEnergyAdvertisingParameters()
Erstellt ein neues Objekt dieser Klasse. Alle Werte werden gemäß der Bluetooth Low Energy-Spezifikation auf ihre Standardwerte initialisiert.
QLowEnergyAdvertisingParameters::QLowEnergyAdvertisingParameters(const QLowEnergyAdvertisingParameters &other)
Erstellt ein neues Objekt dieser Klasse, das eine Kopie von ` other` ist.
[noexcept] QLowEnergyAdvertisingParameters::~QLowEnergyAdvertisingParameters()
Zerstört dieses Objekt.
QLowEnergyAdvertisingParameters::FilterPolicy QLowEnergyAdvertisingParameters::filterPolicy() const
Gibt die Filterrichtlinie zurück, die festlegt, wie die Whitelist verwendet wird. Die Standardeinstellung lautet „ QLowEnergyAdvertisingParameters::IgnoreWhiteList “.
int QLowEnergyAdvertisingParameters::maximumInterval() const
Gibt das maximale Werbeintervall in Millisekunden zurück. Der Standardwert beträgt 1280.
int QLowEnergyAdvertisingParameters::minimumInterval() const
Gibt das minimale Werbeintervall in Millisekunden zurück. Der Standardwert beträgt 1280.
QLowEnergyAdvertisingParameters::Mode QLowEnergyAdvertisingParameters::mode() const
Gibt den Werbemodus zurück. Der Standardwert ist „ QLowEnergyAdvertisingParameters::AdvInd “.
Siehe auch „ setMode()“.
void QLowEnergyAdvertisingParameters::setInterval(quint16 minimum, quint16 maximum)
Legt das Advertising-Intervall fest. Dabei handelt es sich um einen Bereich, der dem Controller eine Ober- und eine Untergrenze dafür vorgibt, wie oft die Advertising-Daten gesendet werden sollen. Sowohl „ minimum “ als auch „ maximum “ werden in Millisekunden angegeben. Ist „ maximum “ kleiner als „ minimum “, wird der Wert auf „ minimum “ gesetzt.
Hinweis: Für das minimale und maximale Intervallgelten Grenzwerte; die genauen Werte hängen vom Modus ab. Werden diese überschritten, wird jeweils der niedrigste bzw. höchste mögliche Wert verwendet.
Die Einstellung des Advertising-Intervalls wird vom BlueZ-DBus-Backend unterstützt, sofern dessen experimenteller Status in späteren Versionen von BlueZ geändert wird (oder das Backend im experimentellen Modus ausgeführt wird).
void QLowEnergyAdvertisingParameters::setMode(QLowEnergyAdvertisingParameters::Mode mode)
Stellt den Werbemodus auf „ mode “ ein.
Siehe auch mode().
void QLowEnergyAdvertisingParameters::setWhiteList(const QList<QLowEnergyAdvertisingParameters::AddressInfo> &whiteList, QLowEnergyAdvertisingParameters::FilterPolicy policy)
Legt die Whitelist fest, die möglicherweise zum Filtern von Scan- und Verbindungsanfragen verwendet wird. Der Parameter „ whiteList “ ist die Liste der Adressen, die zum Filtern verwendet werden sollen, und „ policy “ legt fest, wie genau „ whiteList “ verwendet werden soll.
Whitelists werden im BlueZ-DBus-Backend nicht unterstützt, da sie von BlueZ nicht unterstützt werden.
Siehe auch whiteList().
[noexcept] void QLowEnergyAdvertisingParameters::swap(QLowEnergyAdvertisingParameters &other)
Tauscht dieses Objekt mit „ other “ aus.
QList<QLowEnergyAdvertisingParameters::AddressInfo> QLowEnergyAdvertisingParameters::whiteList() const
Gibt die Whitelist zurück, die zum Filtern von Scan- und Verbindungsanfragen verwendet wird. Standardmäßig ist diese Liste leer.
Siehe auch ` setWhiteList()`.
QLowEnergyAdvertisingParameters &QLowEnergyAdvertisingParameters::operator=(const QLowEnergyAdvertisingParameters &other)
Erstellt eine Kopie von „ other “ und gibt den neuen Wert dieses Objekts zurück.
Verwandte Nicht-Mitglieder
bool operator!=(const QLowEnergyAdvertisingParameters &a, const QLowEnergyAdvertisingParameters &b)
Gibt „ true “ zurück, wenn „ a “ und „ b “ hinsichtlich ihres öffentlichen Zustands nicht gleich sind; andernfalls wird „ false “ zurückgegeben.
bool operator==(const QLowEnergyAdvertisingParameters &a, const QLowEnergyAdvertisingParameters &b)
Gibt „ true “ zurück, wenn „ a “ und „ b “ hinsichtlich ihres öffentlichen Zustands identisch 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.
