QLowEnergyAdvertisingParameters Class
La clase QLowEnergyAdvertisingParameters representa los parámetros utilizados para la publicidad Bluetooth Low Energy. Más...
| Cabecera: | #include <QLowEnergyAdvertisingParameters> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Bluetooth)target_link_libraries(mytarget PRIVATE Qt6::Bluetooth) |
| qmake: | QT += bluetooth |
- Lista de todos los miembros, incluyendo los heredados
- QLowEnergyAdvertisingParameters es parte de Implicitly Shared Classes.
Tipos Públicos
| class | AddressInfo |
| enum | FilterPolicy { IgnoreWhiteList, UseWhiteListForScanning, UseWhiteListForConnecting, UseWhiteListForScanningAndConnecting } |
| enum | Mode { AdvInd, AdvScanInd, AdvNonConnInd } |
Funciones Públicas
| 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) |
No miembros relacionados
| bool | operator!=(const QLowEnergyAdvertisingParameters &a, const QLowEnergyAdvertisingParameters &b) |
| bool | operator==(const QLowEnergyAdvertisingParameters &a, const QLowEnergyAdvertisingParameters &b) |
Descripción detallada
Cuando se ejecuta el procedimiento de publicidad, se pueden configurar una serie de parámetros, como la velocidad a la que se realizará la publicidad o qué clientes, si los hay, pueden conectarse al dispositivo de publicidad. Estos parámetros se configuran a través de esta clase, y sus valores se utilizarán cuando se inicie la publicidad llamando a QLowEnergyController::startAdvertising().
Véase también QLowEnergyAdvertisingData y QLowEnergyController::startAdvertising().
Documentación de tipos de miembros
enum QLowEnergyAdvertisingParameters::FilterPolicy
Especifica la semántica de la lista blanca.
| Constante | Valor | Descripción |
|---|---|---|
QLowEnergyAdvertisingParameters::IgnoreWhiteList | 0x00 | El valor de la lista blanca se ignora, es decir, no se realiza ningún filtrado ni para las peticiones de escaneo ni para las de conexión cuando se utiliza publicidad no dirigida. |
QLowEnergyAdvertisingParameters::UseWhiteListForScanning | 0x01 | La lista blanca se utiliza cuando se gestionan solicitudes de exploración, pero se ignora para las solicitudes de conexión. |
QLowEnergyAdvertisingParameters::UseWhiteListForConnecting | 0x02 | La lista blanca se utiliza cuando se gestionan solicitudes de conexión, pero se ignora para las solicitudes de escaneo. |
QLowEnergyAdvertisingParameters::UseWhiteListForScanningAndConnecting | 0x03 | La lista blanca se utiliza tanto para las solicitudes de conexión como para las de escaneo. |
Véase también QLowEnergyAdvertisingParameters::whiteList().
enum QLowEnergyAdvertisingParameters::Mode
Especifica de qué manera anunciarse.
| Constante | Valor | Descripción |
|---|---|---|
QLowEnergyAdvertisingParameters::AdvInd | 0x0 | Para publicidad no dirigida y conectable. La publicidad no está dirigida a un dispositivo específico y un dispositivo que vea la publicidad puede conectarse al dispositivo publicitario o enviar solicitudes de escaneado. |
QLowEnergyAdvertisingParameters::AdvScanInd | 0x2 | Para publicidad no dirigida, escaneable. La publicidad no está dirigida a un dispositivo específico y un dispositivo que vea el anuncio puede enviar una solicitud de exploración al dispositivo publicitario, pero no puede conectarse a él. |
QLowEnergyAdvertisingParameters::AdvNonConnInd | 0x3 | Para publicidad no dirigida y no conectable. La publicidad no está dirigida a un dispositivo específico. Un dispositivo que vea el anuncio no puede conectarse al dispositivo anunciante ni enviar una solicitud de exploración. Este modo implica, por tanto, una difusión pura. |
Documentación de las funciones
QLowEnergyAdvertisingParameters::QLowEnergyAdvertisingParameters()
Construye un nuevo objeto de esta clase. Todos los valores se inicializan a sus valores predeterminados de acuerdo con la especificación Bluetooth Low Energy.
QLowEnergyAdvertisingParameters::QLowEnergyAdvertisingParameters(const QLowEnergyAdvertisingParameters &other)
Construye un nuevo objeto de esta clase que es una copia de other.
[noexcept] QLowEnergyAdvertisingParameters::~QLowEnergyAdvertisingParameters()
Destruye este objeto.
QLowEnergyAdvertisingParameters::FilterPolicy QLowEnergyAdvertisingParameters::filterPolicy() const
Devuelve la política de filtrado que determina cómo se utiliza la lista blanca. El valor predeterminado es QLowEnergyAdvertisingParameters::IgnoreWhiteList.
int QLowEnergyAdvertisingParameters::maximumInterval() const
Devuelve el intervalo máximo de publicidad en milisegundos. El valor predeterminado es 1280.
int QLowEnergyAdvertisingParameters::minimumInterval() const
Devuelve el intervalo mínimo de publicidad en milisegundos. El valor predeterminado es 1280.
QLowEnergyAdvertisingParameters::Mode QLowEnergyAdvertisingParameters::mode() const
Devuelve el modo de publicidad. Por defecto es QLowEnergyAdvertisingParameters::AdvInd.
Véase también setMode().
void QLowEnergyAdvertisingParameters::setInterval(quint16 minimum, quint16 maximum)
Establece el intervalo de publicidad. Se trata de un intervalo que proporciona al controlador un límite superior y otro inferior para la frecuencia de envío de los datos publicitarios. Tanto minimum como maximum se indican en milisegundos. Si maximum es menor que minimum, se establecerá el valor de minimum.
Nota: Existen límites para el intervalo mínimo y máximo; los valores exactos dependen del modo. Si se superan, se utilizará el valor más bajo o más alto posible, respectivamente.
La configuración del intervalo de publicidad es compatible con el backend DBus de BlueZ si se cambia su estado experimental en versiones posteriores de BlueZ (o se ejecuta en modo experimental).
void QLowEnergyAdvertisingParameters::setMode(QLowEnergyAdvertisingParameters::Mode mode)
Establece el modo de publicidad en mode.
Véase también mode().
void QLowEnergyAdvertisingParameters::setWhiteList(const QList<QLowEnergyAdvertisingParameters::AddressInfo> &whiteList, QLowEnergyAdvertisingParameters::FilterPolicy policy)
Establece la lista blanca que se utiliza potencialmente para filtrar las solicitudes de escaneo y conexión. El parámetro whiteList es la lista de direcciones a utilizar para el filtrado, y policy especifica cómo utilizar exactamente whiteList.
Las listas blancas no están soportadas en el backend BlueZ DBus ya que no son soportadas por BlueZ.
Véase también whiteList().
[noexcept] void QLowEnergyAdvertisingParameters::swap(QLowEnergyAdvertisingParameters &other)
Intercambia este objeto con other.
QList<QLowEnergyAdvertisingParameters::AddressInfo> QLowEnergyAdvertisingParameters::whiteList() const
Devuelve la lista blanca utilizada para filtrar las solicitudes de exploración y conexión. Por defecto, esta lista está vacía.
Véase también setWhiteList().
QLowEnergyAdvertisingParameters &QLowEnergyAdvertisingParameters::operator=(const QLowEnergyAdvertisingParameters &other)
Hace de este objeto una copia de other y devuelve el nuevo valor de este objeto.
No miembros relacionados
bool operator!=(const QLowEnergyAdvertisingParameters &a, const QLowEnergyAdvertisingParameters &b)
Devuelve true si a y b no son iguales con respecto a su estado público, en caso contrario devuelve false.
bool operator==(const QLowEnergyAdvertisingParameters &a, const QLowEnergyAdvertisingParameters &b)
Devuelve true si a y b son iguales con respecto a su estado público, en caso contrario devuelve 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.
