QLowEnergyAdvertisingParameters Class
Die Klasse QLowEnergyAdvertisingParameters repräsentiert die für Bluetooth Low Energy Werbung verwendeten Parameter. Mehr...
| Header: | #include <QLowEnergyAdvertisingParameters> |
| qmake: | QT += bluetooth |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QLowEnergyAdvertisingParameters ist Teil von Implicitly Shared Classes.
Ö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) |
Detaillierte Beschreibung
Bei der Ausführung der Werbeprozedur kann eine Reihe von Parametern konfiguriert werden, z. B. wie schnell geworben werden soll oder welche Clients sich gegebenenfalls mit dem werbenden Gerät verbinden können. Diese Parameter werden über diese Klasse gesetzt, und ihre Werte werden verwendet, wenn die Werbung durch den Aufruf von QLowEnergyController::startAdvertising() gestartet wird.
Siehe auch QLowEnergyAdvertisingData und QLowEnergyController::startAdvertising().
Dokumentation der Mitgliedstypen
enum QLowEnergyAdvertisingParameters::FilterPolicy
Gibt die Semantik der weißen Liste an.
| Konstante | Wert | Beschreibung |
|---|---|---|
QLowEnergyAdvertisingParameters::IgnoreWhiteList | 0x00 | Der Wert der Whitelist wird ignoriert, d. h. bei ungerichteter Werbung findet weder für Scan- noch für Verbindungsanfragen eine Filterung statt. |
QLowEnergyAdvertisingParameters::UseWhiteListForScanning | 0x01 | Die Whitelist wird bei der Bearbeitung von Scan-Anfragen verwendet, aber bei Verbindungsanfragen ignoriert. |
QLowEnergyAdvertisingParameters::UseWhiteListForConnecting | 0x02 | Die Whitelist wird bei der Bearbeitung von Verbindungsanfragen verwendet, aber bei Scan-Anfragen ignoriert. |
QLowEnergyAdvertisingParameters::UseWhiteListForScanningAndConnecting | 0x03 | Die Whitelist wird sowohl für Verbindungs- als auch für Suchanfragen verwendet. |
Siehe auch QLowEnergyAdvertisingParameters::whiteList().
enum QLowEnergyAdvertisingParameters::Mode
Gibt an, auf welche Weise geworben werden soll.
| Konstante | Wert | Beschreibung |
|---|---|---|
QLowEnergyAdvertisingParameters::AdvInd | 0x0 | Für nicht gerichtete, verbindungsfähige Werbung. Die Werbung ist nicht an ein bestimmtes Gerät gerichtet, und ein Gerät, das die Werbung sieht, kann eine Verbindung mit dem werbenden Gerät herstellen oder Scan-Anforderungen senden. |
QLowEnergyAdvertisingParameters::AdvScanInd | 0x2 | Für ungerichtete, scannbare Werbung. Die Werbung ist nicht an ein bestimmtes Gerät gerichtet, und ein Gerät, das die Werbung sieht, kann eine Scan-Anfrage an das Werbegerät senden, aber keine Verbindung zu ihm herstellen. |
QLowEnergyAdvertisingParameters::AdvNonConnInd | 0x3 | Für nicht gerichtete, nicht verbindungsfähige Werbung. Die Werbung ist nicht an ein bestimmtes Gerät gerichtet. Ein Gerät, das die Werbung sieht, kann weder eine Verbindung zum werbenden Gerät herstellen, noch eine Scan-Anfrage senden. Dieser Modus impliziert also reines Broadcasting. |
Dokumentation der Mitgliedsfunktionen
QLowEnergyAdvertisingParameters::QLowEnergyAdvertisingParameters()
Konstruiert ein neues Objekt dieser Klasse. Alle Werte werden gemäß der Bluetooth Low Energy Spezifikation auf ihre Standardwerte initialisiert.
QLowEnergyAdvertisingParameters::QLowEnergyAdvertisingParameters(const QLowEnergyAdvertisingParameters &other)
Konstruiert 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 bestimmt, wie die weiße Liste verwendet wird. Der Standardwert ist QLowEnergyAdvertisingParameters::IgnoreWhiteList.
int QLowEnergyAdvertisingParameters::maximumInterval() const
Gibt das maximale Werbeintervall in Millisekunden zurück. Der Standardwert ist 1280.
int QLowEnergyAdvertisingParameters::minimumInterval() const
Gibt das minimale Werbeintervall in Millisekunden zurück. Der Standardwert ist 1280.
QLowEnergyAdvertisingParameters::Mode QLowEnergyAdvertisingParameters::mode() const
Gibt den Werbemodus zurück. Die Vorgabe ist QLowEnergyAdvertisingParameters::AdvInd.
Siehe auch setMode().
void QLowEnergyAdvertisingParameters::setInterval(quint16 minimum, quint16 maximum)
Legt das Werbeintervall fest. Hierbei handelt es sich um einen Bereich, der dem Controller eine Ober- und eine Untergrenze für die Häufigkeit des Versendens der Werbedaten vorgibt. Sowohl minimum als auch maximum werden in Millisekunden angegeben. Wenn maximum kleiner als minimum ist, wird es auf den Wert von minimum gesetzt.
Hinweis: Es gibt Grenzen für das minimale und maximale Intervall; die genauen Werte hängen vom Modus ab. Wenn sie überschritten werden, wird der niedrigste bzw. der höchste mögliche Wert verwendet.
Die Einstellung des Werbeintervalls wird auf dem BlueZ DBus-Backend unterstützt, wenn sein experimenteller Status in späteren Versionen von BlueZ geändert wird (oder im experimentellen Modus ausgeführt wird).
void QLowEnergyAdvertisingParameters::setMode(QLowEnergyAdvertisingParameters::Mode mode)
Setzt den Werbemodus auf mode.
Siehe auch mode().
void QLowEnergyAdvertisingParameters::setWhiteList(const QList<QLowEnergyAdvertisingParameters::AddressInfo> &whiteList, QLowEnergyAdvertisingParameters::FilterPolicy policy)
Legt die Whitelist fest, die zum Filtern von Scan- und Verbindungsanfragen verwendet werden kann. Der Parameter whiteList ist die Liste der Adressen, die für die Filterung verwendet werden sollen, und policy gibt an, wie genau whiteList verwendet werden soll.
Whitelists werden auf dem 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 weiße Liste zurück, die zum Filtern von Such- und Verbindungsanfragen verwendet wird. Standardmäßig ist diese Liste leer.
Siehe auch setWhiteList().
QLowEnergyAdvertisingParameters &QLowEnergyAdvertisingParameters::operator=(const QLowEnergyAdvertisingParameters &other)
Macht dieses Objekt zu einer 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 in Bezug auf ihren öffentlichen Zustand nicht gleich sind, andernfalls false.
bool operator==(const QLowEnergyAdvertisingParameters &a, const QLowEnergyAdvertisingParameters &b)
Gibt true zurück, wenn a und b in Bezug auf ihren öffentlichen Zustand gleich sind, andernfalls false.
© 2025 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.
