QLowEnergyAdvertisingParameters Class
La clase QLowEnergyAdvertisingParameters representa los parámetros utilizados para la publicidad Bluetooth Low Energy. Más información...
| 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, incluidos los miembros heredados
- QLowEnergyAdvertisingParameters forma parte de las clases compartidas implícitamente.
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) |
Elementos no miembros relacionados
| bool | operator!=(const QLowEnergyAdvertisingParameters &a, const QLowEnergyAdvertisingParameters &b) |
| bool | operator==(const QLowEnergyAdvertisingParameters &a, const QLowEnergyAdvertisingParameters &b) |
Descripción detallada
Al ejecutar el procedimiento de publicidad, se pueden configurar varios parámetros, como la velocidad de la publicidad o qué clientes, si los hay, pueden conectarse al dispositivo que realiza la publicidad. Estos parámetros se establecen 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 sobre los tipos de miembros
enum QLowEnergyAdvertisingParameters::FilterPolicy
Especifica la semántica de la lista blanca.
| Constante | Valor | Descripción |
|---|---|---|
QLowEnergyAdvertisingParameters::IgnoreWhiteList | 0x00 | Se ignora el valor de la lista blanca, es decir, no se aplica ningún filtrado ni a las solicitudes de escaneo ni a las de conexión cuando se utiliza la publicidad no dirigida. |
QLowEnergyAdvertisingParameters::UseWhiteListForScanning | 0x01 | La lista blanca se utiliza al gestionar las solicitudes de escaneo, pero se ignora en el caso de las solicitudes de conexión. |
QLowEnergyAdvertisingParameters::UseWhiteListForConnecting | 0x02 | La lista blanca se utiliza al gestionar las solicitudes de conexión, pero se ignora en el caso de las solicitudes de exploración. |
QLowEnergyAdvertisingParameters::UseWhiteListForScanningAndConnecting | 0x03 | La lista blanca se utiliza tanto para las solicitudes de conexión como para las de exploración. |
Véase también QLowEnergyAdvertisingParameters::whiteList().
enum QLowEnergyAdvertisingParameters::Mode
Especifica de qué forma se va a hacer publicidad.
| 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 el anuncio puede conectarse al dispositivo anunciante o enviar solicitudes de escaneo. |
QLowEnergyAdvertisingParameters::AdvScanInd | 0x2 | Para publicidad no dirigida y escaneable. La publicidad no va dirigida a un dispositivo específico y un dispositivo que vea el anuncio puede enviar una solicitud de escaneo al dispositivo anunciante, 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 publicitario, ni puede enviar una solicitud de escaneo. Por lo tanto, este modo implica una simple difusión. |
Documentación de las funciones de miembro
QLowEnergyAdvertisingParameters::QLowEnergyAdvertisingParameters()
Crea un nuevo objeto de esta clase. Todos los valores se inicializan con sus valores por defecto, de acuerdo con la especificación Bluetooth Low Energy.
QLowEnergyAdvertisingParameters::QLowEnergyAdvertisingParameters(const QLowEnergyAdvertisingParameters &other)
Crea 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 por defecto es 1280.
QLowEnergyAdvertisingParameters::Mode QLowEnergyAdvertisingParameters::mode() const
Devuelve el modo de publicidad. El valor 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 rango que proporciona al controlador un límite superior y uno inferior para la frecuencia con la que debe enviar los datos de publicidad. Tanto « minimum » como « maximum » se expresan en milisegundos. Si « maximum » es menor que « minimum », se establecerá en 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 modifica su estado experimental en versiones posteriores de BlueZ (o si 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 podría utilizarse para filtrar las solicitudes de escaneo y conexión. El parámetro « whiteList » es la lista de direcciones que se utilizarán para el filtrado, y « policy » especifica cómo utilizar exactamente « whiteList ».
Las listas blancas no son compatibles con el backend DBus de BlueZ, ya que BlueZ no las admite.
Véase también whiteList().
[noexcept] void QLowEnergyAdvertisingParameters::swap(QLowEnergyAdvertisingParameters &other)
Intercambia este objeto por other.
QList<QLowEnergyAdvertisingParameters::AddressInfo> QLowEnergyAdvertisingParameters::whiteList() const
Devuelve la lista blanca que se utiliza para filtrar las solicitudes de escaneo y conexión. Por defecto, esta lista está vacía.
Véase también setWhiteList().
QLowEnergyAdvertisingParameters &QLowEnergyAdvertisingParameters::operator=(const QLowEnergyAdvertisingParameters &other)
Convierte este objeto en una copia de ` other ` y devuelve el nuevo valor de este objeto.
Elementos no miembros relacionados
bool operator!=(const QLowEnergyAdvertisingParameters &a, const QLowEnergyAdvertisingParameters &b)
Devuelve ` true ` si ` a ` y ` b ` no son iguales en cuanto 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 en cuanto 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.