En esta página

QLowEnergyAdvertisingData Class

La clase `QLowEnergyAdvertisingData` representa los datos que se van a transmitir durante la publicidad de Bluetooth Low Energy. Más información...

Cabecera: #include <QLowEnergyAdvertisingData>
CMake: find_package(Qt6 REQUIRED COMPONENTS Bluetooth)
target_link_libraries(mytarget PRIVATE Qt6::Bluetooth)
qmake: QT += bluetooth

Tipos públicos

enum Discoverability { DiscoverabilityNone, DiscoverabilityLimited, DiscoverabilityGeneral }

Funciones públicas

QLowEnergyAdvertisingData()
QLowEnergyAdvertisingData(const QLowEnergyAdvertisingData &other)
~QLowEnergyAdvertisingData()
QLowEnergyAdvertisingData::Discoverability discoverability() const
bool includePowerLevel() const
QString localName() const
QByteArray manufacturerData() const
quint16 manufacturerId() const
QByteArray rawData() const
QList<QBluetoothUuid> services() const
void setDiscoverability(QLowEnergyAdvertisingData::Discoverability mode)
void setIncludePowerLevel(bool doInclude)
void setLocalName(const QString &name)
void setManufacturerData(quint16 id, const QByteArray &data)
void setRawData(const QByteArray &data)
void setServices(const QList<QBluetoothUuid> &services)
void swap(QLowEnergyAdvertisingData &other)
QLowEnergyAdvertisingData &operator=(const QLowEnergyAdvertisingData &other)

Miembros públicos estáticos

bool operator!=(const QLowEnergyAdvertisingData &data1, const QLowEnergyAdvertisingData &data2)
bool operator==(const QLowEnergyAdvertisingData &data1, const QLowEnergyAdvertisingData &data2)

Descripción detallada

Estos datos pueden incluir el nombre del dispositivo, los servicios GATT que ofrece el dispositivo, etc. Los datos configurados a través de esta clase se utilizarán cuando se inicie la publicidad llamando a QLowEnergyController::startAdvertising(). Los objetos de esta clase pueden representar un paquete de datos de publicidad o un paquete de respuesta de exploración.

Limitaciones de los datos de publicidad

La longitud máxima de los datos de publicidad depende del dispositivo Bluetooth y de la pila Bluetooth de la plataforma. Para garantizar la máxima compatibilidad, se recomienda limitar el tamaño de los datos de publicidad al límite heredado de 31 bytes.

Si el conjunto de datos de longitud variable establecido a través de esta clase supera el límite admitido, el comportamiento dependerá de la implementación subyacente de la pila de Bluetooth. Las posibilidades más habituales son:

  • los datos adicionales pueden truncarse u omitirse por completo;
  • la publicidad no se inicia.

Por ejemplo, en Android, la publicidad fallará si los datos de publicidad superan los 31 bytes. En el backend DBus de BlueZ, el límite de longitud de la publicidad y el comportamiento cuando se supera dicho límite dependen de BlueZ; por ejemplo, puede que admita publicidad ampliada o que no consiga iniciar la publicidad.

Véase también QLowEnergyAdvertisingParameters y QLowEnergyController::startAdvertising().

Documentación sobre tipos de miembros

enum QLowEnergyAdvertisingData::Discoverability

La capacidad de detección del dispositivo publicitario, tal y como se define en el Perfil de Acceso Genérico.

ConstanteValorDescripción
QLowEnergyAdvertisingData::DiscoverabilityNone0El dispositivo anunciante no desea ser detectable por los dispositivos de exploración.
QLowEnergyAdvertisingData::DiscoverabilityLimited1El dispositivo anunciante desea ser detectable con alta prioridad. Tenga en cuenta que este modo no es compatible con el uso de una lista blanca. Se asume siempre que el valor de « QLowEnergyAdvertisingParameters::filterPolicy()» es « QLowEnergyAdvertisingParameters::IgnoreWhiteList » cuando se utiliza la detectabilidad limitada.
QLowEnergyAdvertisingData::DiscoverabilityGeneral2El dispositivo anunciante desea que los dispositivos de escaneo puedan detectarlo.

Documentación de funciones miembro

QLowEnergyAdvertisingData::QLowEnergyAdvertisingData()

Crea un nuevo objeto de esta clase. Todos los valores se inicializan con sus valores por defecto, de acuerdo con la especificación de Bluetooth Low Energy.

QLowEnergyAdvertisingData::QLowEnergyAdvertisingData(const QLowEnergyAdvertisingData &other)

Crea un nuevo objeto de esta clase que es una copia de other.

[noexcept] QLowEnergyAdvertisingData::~QLowEnergyAdvertisingData()

Destruye este objeto.

QLowEnergyAdvertisingData::Discoverability QLowEnergyAdvertisingData::discoverability() const

Devuelve el modo de visibilidad del dispositivo publicitario. El valor por defecto es « DiscoverabilityNone ».

Véase también setDiscoverability().

bool QLowEnergyAdvertisingData::includePowerLevel() const

Devuelve si se debe incluir el nivel de potencia de transmisión del dispositivo en los datos de publicidad. El valor por defecto es « false ».

Véase también ` setIncludePowerLevel()`.

[static] quint16 QLowEnergyAdvertisingData::invalidManufacturerId()

Devuelve un identificador de fabricante no válido. Si se establece este valor como identificador de fabricante (que es lo que ocurre por defecto), no aparecerán datos del fabricante en los datos publicitarios.

QString QLowEnergyAdvertisingData::localName() const

Devuelve el nombre del dispositivo local que se va a anunciar.

Véase también setLocalName().

QByteArray QLowEnergyAdvertisingData::manufacturerData() const

Devuelve los datos del fabricante. El valor por defecto es una matriz de bytes vacía.

Véase también setManufacturerData().

quint16 QLowEnergyAdvertisingData::manufacturerId() const

Devuelve el identificador del fabricante. El valor por defecto es QLowEnergyAdvertisingData::invalidManufacturerId(), lo que significa que los datos no se darán a conocer.

QByteArray QLowEnergyAdvertisingData::rawData() const

Devuelve los datos sin procesar proporcionados por el usuario que se van a publicar. El valor por defecto es una matriz de bytes vacía.

Véase también setRawData().

QList<QBluetoothUuid> QLowEnergyAdvertisingData::services() const

Devuelve la lista de UUID de servicios que se van a anunciar. Por defecto, esta lista está vacía.

Véase también setServices().

void QLowEnergyAdvertisingData::setDiscoverability(QLowEnergyAdvertisingData::Discoverability mode)

Establece el tipo de detectabilidad del dispositivo de publicidad en « mode ».

Nota: La informaciónde detectabilidad solo puede aparecer en un paquete de datos publicitarios real. Si este objeto actúa como datos de respuesta a un escaneo, una llamada a esta función no tendrá ningún efecto sobre la respuesta al escaneo enviada.

Véase también discoverability().

void QLowEnergyAdvertisingData::setIncludePowerLevel(bool doInclude)

Especifica si se debe incluir el nivel de potencia de transmisión del dispositivo en los datos de publicidad. Si doInclude es true, los datos se incluirán; de lo contrario, no se incluirán.

Véase también includePowerLevel().

void QLowEnergyAdvertisingData::setLocalName(const QString &name)

Especifica que « name » debe transmitirse como nombre del dispositivo. Si el nombre completo no cabe en el paquete de datos de publicidad, se envía un nombre abreviado, tal y como se describe en la especificación de Bluetooth Low Energy.

En Android, el nombre local no se puede modificar. Android utiliza siempre el nombre del dispositivo. Si este nombre local no está vacío, la implementación de Android incluye el nombre del dispositivo en el paquete de publicidad; de lo contrario, el nombre del dispositivo se omite en dicho paquete.

Véase también localName().

void QLowEnergyAdvertisingData::setManufacturerData(quint16 id, const QByteArray &data)

Establece el identificador del fabricante y los datos. El parámetro « id » es un identificador de empresa asignado por Bluetooth SIG. El parámetro « data » es un valor arbitrario.

Nota: macOS e iOS no admiten la difusión del identificador del fabricante ni de los datos, por lo que los parámetros proporcionados se ignorarán en estas plataformas.

Véase también manufacturerData().

void QLowEnergyAdvertisingData::setRawData(const QByteArray &data)

Establece los datos que se van a anunciar a data. Si el valor no es una matriz de bytes vacía, se enviará tal cual como datos de anuncio y se ignorarán todos los demás datos de este objeto. Esto se puede utilizar para enviar datos no estándar.

Nota: Si data tiene más de 31 bytes, se truncará. Es responsabilidad del autor de la llamada asegurarse de que data esté bien formado.

La configuración de datos de publicidad sin procesar solo es compatible con el backend de la API del núcleo de Bluetooth para Linux. Otros backends no permiten especificar los datos de publicidad sin procesar como un campo global.

Véase también rawData().

void QLowEnergyAdvertisingData::setServices(const QList<QBluetoothUuid> &services)

Especifica que deben anunciarse los UUID de servicio que figuran en services. Si la lista completa no cabe en el paquete, se envía una lista incompleta tal y como establece la especificación de Bluetooth Low Energy.

Véase también services().

[noexcept] void QLowEnergyAdvertisingData::swap(QLowEnergyAdvertisingData &other)

Intercambia este objeto con other.

QLowEnergyAdvertisingData &QLowEnergyAdvertisingData::operator=(const QLowEnergyAdvertisingData &other)

Convierte este objeto en una copia de ` other ` y devuelve el nuevo valor de este objeto.

Elementos relacionados que no son miembros

bool operator!=(const QLowEnergyAdvertisingData &data1, const QLowEnergyAdvertisingData &data2)

Devuelve « true » si « data1 » y « data2 » no son iguales en cuanto a su estado público; en caso contrario, devuelve « false ».

bool operator==(const QLowEnergyAdvertisingData &data1, const QLowEnergyAdvertisingData &data2)

Devuelve ` true ` si ` data1 ` y ` data2 ` 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.