QLowEnergyController Class
La clase QLowEnergyController permite acceder a dispositivos Bluetooth Low Energy. Más información...
| Encabezado: | #include <QLowEnergyController> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Bluetooth) target_link_libraries(mytarget PRIVATE Qt6::Bluetooth) |
| qmake: | QT += bluetooth |
| Heredado de: | QObject |
Tipos públicos
| enum | ControllerState { UnconnectedState, ConnectingState, ConnectedState, DiscoveringState, DiscoveredState, …, AdvertisingState } |
| enum | Error { NoError, UnknownError, UnknownRemoteDeviceError, NetworkError, InvalidBluetoothAdapterError, …, RssiReadError } |
| enum | RemoteAddressType { PublicAddress, RandomAddress } |
| enum | Role { CentralRole, PeripheralRole } |
Funciones públicas
| virtual | ~QLowEnergyController() |
| QLowEnergyService * | addService(const QLowEnergyServiceData &service, QObject *parent = nullptr) |
| void | connectToDevice() |
| QLowEnergyService * | createServiceObject(const QBluetoothUuid &serviceUuid, QObject *parent = nullptr) |
| void | disconnectFromDevice() |
| void | discoverServices() |
| QLowEnergyController::Error | error() const |
| QString | errorString() const |
| QBluetoothAddress | localAddress() const |
(since 6.2) int | mtu() const |
(since 6.5) void | readRssi() |
| QBluetoothAddress | remoteAddress() const |
| QLowEnergyController::RemoteAddressType | remoteAddressType() const |
| QBluetoothUuid | remoteDeviceUuid() const |
| QString | remoteName() const |
| void | requestConnectionUpdate(const QLowEnergyConnectionParameters ¶meters) |
| QLowEnergyController::Role | role() const |
| QList<QBluetoothUuid> | services() const |
| void | setRemoteAddressType(QLowEnergyController::RemoteAddressType type) |
| void | startAdvertising(const QLowEnergyAdvertisingParameters ¶meters, const QLowEnergyAdvertisingData &advertisingData, const QLowEnergyAdvertisingData &scanResponseData = QLowEnergyAdvertisingData()) |
| QLowEnergyController::ControllerState | state() const |
| void | stopAdvertising() |
Señales
| void | connected() |
| void | connectionUpdated(const QLowEnergyConnectionParameters &newParameters) |
| void | disconnected() |
| void | discoveryFinished() |
(since 6.2) void | errorOccurred(QLowEnergyController::Error newError) |
| void | mtuChanged(int mtu) |
(since 6.5) void | rssiRead(qint16 rssi) |
| void | serviceDiscovered(const QBluetoothUuid &newService) |
| void | stateChanged(QLowEnergyController::ControllerState state) |
Miembros públicos estáticos
| QLowEnergyController * | createCentral(const QBluetoothDeviceInfo &remoteDevice, QObject *parent = nullptr) |
| QLowEnergyController * | createCentral(const QBluetoothDeviceInfo &remoteDevice, const QBluetoothAddress &localDevice, QObject *parent = nullptr) |
| QLowEnergyController * | createPeripheral(QObject *parent = nullptr) |
(since 6.2) QLowEnergyController * | createPeripheral(const QBluetoothAddress &localDevice, QObject *parent = nullptr) |
Descripción detallada
QLowEnergyController actúa como punto de partida para el desarrollo de Bluetooth Low Energy.
Bluetooth Low Energy define dos tipos de dispositivos: el periférico y el central. Cada uno de ellos desempeña una tarea diferente. El dispositivo periférico proporciona datos que son utilizados por los dispositivos centrales. Un ejemplo podría ser un sensor de humedad que mide la humedad en un jardín de invierno. Un dispositivo como un teléfono móvil podría leer el valor del sensor y mostrárselo al usuario en el contexto más amplio de todos los sensores del mismo entorno. En este caso, el sensor es el dispositivo periférico y el teléfono móvil actúa como dispositivo central.
Un controlador en el rol central se crea mediante el método de fábrica ` createCentral()`. Dicho objeto actúa esencialmente como un marcador de posición frente a un dispositivo periférico remoto de baja energía, lo que permite funciones como el descubrimiento de servicios y el seguimiento del estado.
Tras haber creado un objeto controlador en el rol central, el primer paso es establecer una conexión mediante connectToDevice(). Una vez establecida la conexión, el método state() del controlador cambia a QLowEnergyController::ConnectedState y se emite la señal connected(). Es importante mencionar que algunas plataformas, como Linux basado en BlueZ, no pueden mantener dos instancias conectadas de QLowEnergyController al mismo dispositivo remoto. En tales casos, la segunda llamada a connectToDevice() puede fallar. Es posible que esta limitación desaparezca en el futuro. La función disconnectFromDevice() se utiliza para interrumpir la conexión existente.
El segundo paso tras establecer la conexión consiste en detectar los servicios que ofrece el dispositivo periférico remoto. Este proceso se inicia mediante ` discoverServices()` y finaliza una vez que se ha emitido la señal ` discoveryFinished()`. Los servicios detectados pueden enumerarse mediante ` services()`.
El último paso consiste en crear objetos de servicio. La función createServiceObject() actúa como fábrica para cada objeto de servicio y espera el UUID del servicio como parámetro. El contexto de llamada debe asumir la propiedad de la instancia QLowEnergyService devuelta.
Cualquier instancia de QLowEnergyService, QLowEnergyCharacteristic o QLowEnergyDescriptor que se cree posteriormente a partir de la conexión de este controlador dejará de ser válida tan pronto como el controlador se desconecte del dispositivo Bluetooth Low Energy remoto.
Un controlador en el rol de periférico se crea mediante el método de fábrica createPeripheral(). Dicho objeto actúa como un dispositivo periférico en sí mismo, habilitando funciones como los servicios de publicidad y permitiendo que los clientes reciban notificaciones sobre cambios en los valores de las características.
Tras haber creado un objeto controlador en el rol de periférico, el primer paso consiste en rellenar el conjunto de servicios GATT ofrecidos a los dispositivos clientes mediante llamadas a addService(). Posteriormente, se llamaría a startAdvertising() para que el dispositivo emita algunos datos y, dependiendo del tipo de publicidad que se realice, también escuche las conexiones entrantes de los clientes GATT.
Véase también QLowEnergyService, QLowEnergyCharacteristic, QLowEnergyDescriptor, QLowEnergyAdvertisingParameters y QLowEnergyAdvertisingData.
Documentación sobre los tipos de miembro
enum QLowEnergyController::ControllerState
Indica el estado del objeto controlador.
| Constante | Valor | Descripción |
|---|---|---|
QLowEnergyController::UnconnectedState | 0 | El controlador no está conectado a un dispositivo remoto. |
QLowEnergyController::ConnectingState | 1 | El controlador está intentando conectarse a un dispositivo remoto. |
QLowEnergyController::ConnectedState | 2 | El controlador está conectado a un dispositivo remoto. |
QLowEnergyController::DiscoveringState | 3 | El controlador está recuperando la lista de servicios que ofrece el dispositivo remoto. |
QLowEnergyController::DiscoveredState | 4 | El controlador ha detectado todos los servicios que ofrece el dispositivo remoto. |
QLowEnergyController::ClosingState | 5 | El controlador está a punto de desconectarse del dispositivo remoto. |
QLowEnergyController::AdvertisingState (since Qt 5.7) | 6 | El controlador está anunciando datos en este momento. |
enum QLowEnergyController::Error
Indica todas las posibles condiciones de error detectadas a lo largo de la vida útil del controlador.
| Constante | Valor | Descripción |
|---|---|---|
QLowEnergyController::NoError | 0 | No se ha producido ningún error. |
QLowEnergyController::UnknownError | 1 | Se ha producido un error desconocido. |
QLowEnergyController::UnknownRemoteDeviceError | 2 | No se ha podido encontrar el dispositivo Bluetooth Low Energy remoto con la dirección pasada al constructor de esta clase. |
QLowEnergyController::NetworkError | 3 | Ha fallado el intento de leer o escribir en el dispositivo remoto. |
QLowEnergyController::InvalidBluetoothAdapterError | 4 | No se ha encontrado el dispositivo Bluetooth local con la dirección pasada al constructor de esta clase o no hay ningún dispositivo Bluetooth local. |
QLowEnergyController::ConnectionError (since Qt 5.5) | 5 | Ha fallado el intento de conectarse al dispositivo remoto. |
QLowEnergyController::AdvertisingError (since Qt 5.7) | 6 | Ha fallado el intento de iniciar la publicidad. |
QLowEnergyController::RemoteHostClosedError (since Qt 5.10) | 7 | El dispositivo remoto ha cerrado la conexión. |
QLowEnergyController::AuthorizationError (since Qt 5.14) | 8 | El dispositivo Bluetooth local ha cerrado la conexión debido a una autorización insuficiente. |
QLowEnergyController::MissingPermissionsError (since Qt 6.4) | 9 | El sistema operativo solicita permisos que el usuario no ha concedido. |
QLowEnergyController::RssiReadError (since Qt 6.5) | 10 | El intento de leer el RSSI (indicador de intensidad de la señal recibida) de un dispositivo remoto ha finalizado con un error. |
enum QLowEnergyController::RemoteAddressType
Indica qué tipo de dirección Bluetooth utiliza el dispositivo remoto.
| Constante | Valor | Descripción |
|---|---|---|
QLowEnergyController::PublicAddress | 0 | El dispositivo remoto utiliza una dirección Bluetooth pública. |
QLowEnergyController::RandomAddress | 1 | Una dirección aleatoria es una característica de seguridad de Bluetooth Low Energy. Los periféricos que utilizan este tipo de direcciones pueden cambiar con frecuencia su dirección Bluetooth. Esta información es necesaria al intentar conectarse a un periférico. |
enum QLowEnergyController::Role
Indica la función del objeto controlador.
| Constante | Valor | Descripción |
|---|---|---|
QLowEnergyController::CentralRole | 0 | El controlador actúa como un cliente que interactúa con un dispositivo remoto que desempeña la función de periférico. El controlador puede iniciar conexiones, detectar servicios y leer y escribir características. |
QLowEnergyController::PeripheralRole | 1 | El controlador puede utilizarse para anunciar servicios y gestionar conexiones entrantes y solicitudes de clientes, actuando como servidor GATT. Un dispositivo remoto conectado al controlador desempeña la función de dispositivo central. Nota: El papel de periférico no es compatible con Windows. Además, en Linux, la gestión del comando ATT «Signed Write» en el lado del servidor requiere BlueZ 5 y una versión del kernel 3.7 o posterior. |
Véase también QLowEnergyController::createCentral() y QLowEnergyController::createPeripheral().
Documentación de las funciones miembro
[virtual noexcept] QLowEnergyController::~QLowEnergyController()
Elimina la instancia de « QLowEnergyController ».
QLowEnergyService *QLowEnergyController::addService(const QLowEnergyServiceData &service, QObject *parent = nullptr)
Crea y devuelve un objeto ` QLowEnergyService ` con ` parent ` procedente de ` service`. El controlador debe encontrarse en ` PeripheralRole ` y en ` UnconnectedState`. El objeto ` service ` debe ser válido.
Nota: Una vez que la instancia del periférico se desconecta del dispositivo central remoto o si se llama manualmente a disconnectFromDevice(), todas las definiciones de servicio que se habían añadido previamente mediante esta función se eliminan del periférico. Por lo tanto, esta función debe volver a llamarse antes de volver a anunciar esta instancia del controlador del periférico. El comportamiento descrito es específico de la conexión y, por lo tanto, no depende de si se ha llamado a stopAdvertising().
Véanse también stopAdvertising(), disconnectFromDevice() y QLowEnergyServiceData::addIncludedService.
void QLowEnergyController::connectToDevice()
Se conecta al dispositivo Bluetooth Low Energy remoto.
Esta función no realiza ninguna acción si el valor de ` state()` del controlador no es igual a ` UnconnectedState`. La señal ` connected()` se emite una vez que la conexión se ha establecido correctamente.
En sistemas Linux/BlueZ, no es posible conectarse al mismo dispositivo remoto utilizando dos instancias de esta clase. La segunda llamada a esta función puede fallar y generar un error. Es posible que esta limitación se elimine en futuras versiones.
Véase también ` disconnectFromDevice()`.
[signal] void QLowEnergyController::connected()
Esta señal se emite cuando el controlador se conecta correctamente a un dispositivo remoto de baja energía (si el controlador se encuentra en el modo « CentralRole ») o si un dispositivo remoto de baja energía se ha conectado al controlador (si el controlador se encuentra en el modo « PeripheralRole »). En iOS, macOS y Android, esta señal no es fiable si el controlador se encuentra en el modo « PeripheralRole ». En iOS y macOS, el controlador solo deduce que algún dispositivo central se ha conectado a nuestro periférico en cuanto dicho dispositivo central intenta escribir o leer una característica o un descriptor. En Android, el controlador supervisa todos los dispositivos GATT conectados. En el backend periférico DBus de BlueZ para Linux, el mando a distancia se considera conectado cuando lee o escribe por primera vez una característica o un descriptor.
[signal] void QLowEnergyController::connectionUpdated(const QLowEnergyConnectionParameters &newParameters)
Esta señal se emite cuando cambian los parámetros de conexión. Esto puede ocurrir como consecuencia de llamar a requestConnectionUpdate() o por otros motivos, por ejemplo, porque el otro extremo de la conexión ha solicitado nuevos parámetros. Los nuevos valores se pueden obtener en newParameters.
Véase también requestConnectionUpdate().
[static] QLowEnergyController *QLowEnergyController::createCentral(const QBluetoothDeviceInfo &remoteDevice, QObject *parent = nullptr)
Devuelve un nuevo objeto de esta clase que se encuentra en el « CentralRole » y tiene como objeto padre « parent ». El « remoteDevice » hace referencia al dispositivo con el que se establecerá la conexión más adelante.
El controlador utiliza el adaptador Bluetooth predeterminado local para la gestión de la conexión.
Véase también QLowEnergyController::CentralRole.
[static] QLowEnergyController *QLowEnergyController::createCentral(const QBluetoothDeviceInfo &remoteDevice, const QBluetoothAddress &localDevice, QObject *parent = nullptr)
Devuelve una nueva instancia de esta clase con ` parent`.
remoteDevice debe contener la dirección del dispositivo Bluetooth Low Energy remoto al que este objeto debe intentar conectarse más adelante.
La conexión se establece a través de ` localDevice`. Si ` localDevice ` no es válido, se selecciona automáticamente el dispositivo local predeterminado. Si ` localDevice ` especifica un dispositivo local que no es un adaptador Bluetooth local, ` error()` se establece en ` InvalidBluetoothAdapterError ` una vez que se llama a ` connectToDevice()`.
Ten en cuenta que solo es posible especificar el dispositivo local que se va a utilizar para la conexión cuando se utiliza BlueZ. El resto de plataformas no admiten esta función.
[static] QLowEnergyController *QLowEnergyController::createPeripheral(QObject *parent = nullptr)
Devuelve un nuevo objeto de esta clase que se encuentra en el espacio de nombres « PeripheralRole » y cuyo objeto padre es « parent ». Normalmente, los siguientes pasos consisten en añadir algunos servicios y, finalmente, llamar a « startAdvertising()» en el objeto devuelto.
El controlador utiliza el adaptador Bluetooth predeterminado local para la gestión de la conexión.
Véase también QLowEnergyController::PeripheralRole.
[static, since 6.2] QLowEnergyController *QLowEnergyController::createPeripheral(const QBluetoothAddress &localDevice, QObject *parent = nullptr)
Devuelve un nuevo objeto de esta clase que se encuentra en PeripheralRole, tiene como objeto padre parent y utiliza localDevice. Normalmente, los siguientes pasos consisten en añadir algunos servicios y, por último, llamar a startAdvertising() sobre el objeto devuelto.
El periférico se crea en localDevice. Si localDevice no es válido, se selecciona automáticamente el dispositivo local por defecto. Si localDevice especifica un dispositivo local que no es un adaptador Bluetooth local, error() se establece en InvalidBluetoothAdapterError.
La selección de localDevice solo es compatible con Linux. En otras plataformas, el parámetro se ignora.
Esta función se introdujo en Qt 6.2.
Véase también QLowEnergyController::PeripheralRole.
QLowEnergyService *QLowEnergyController::createServiceObject(const QBluetoothUuid &serviceUuid, QObject *parent = nullptr)
Crea una instancia del servicio representado por ` serviceUuid`. El parámetro ` serviceUuid ` debe haberse obtenido mediante ` services()`.
El llamante asume la propiedad del puntero devuelto y puede pasar un parámetro parent como propietario por defecto.
Esta función devuelve un puntero nulo si no se encuentra ningún servicio con serviceUuid en el dispositivo remoto o si el controlador está desconectado.
Esta función también puede devolver instancias de servicios secundarios. Las relaciones de inclusión entre servicios pueden expresarse mediante ` QLowEnergyService::includedServices()`.
Si esta función se invoca varias veces utilizando el mismo UUID de servicio, las instancias de ` QLowEnergyService ` devueltas comparten sus datos internos. Por lo tanto, si una de las instancias inicia la detección de los detalles del servicio, las demás instancias pasan automáticamente también al estado de detección.
Véase también services().
void QLowEnergyController::disconnectFromDevice()
Se desconecta del dispositivo remoto.
Cualquier instancia de ` QLowEnergyService`, ` QLowEnergyCharacteristic ` o ` QLowEnergyDescriptor ` resultante de la conexión actual queda automáticamente invalidada. Una vez que cualquiera de esos objetos queda invalidado, permanece así incluso si este objeto controlador se vuelve a conectar.
Esta función no realiza ninguna acción si el controlador se encuentra en el modo UnconnectedState.
Si el controlador se encuentra en el rol de periférico, deja de anunciar y elimina todos los servicios que se hayan añadido previamente mediante addService(). Para reutilizar la instancia de QLowEnergyController, la aplicación debe volver a añadir los servicios y reiniciar el modo de anuncio llamando a startAdvertising().
Véase también connectToDevice().
[signal] void QLowEnergyController::disconnected()
Esta señal se emite cuando el controlador se desconecta del dispositivo remoto de baja energía o viceversa. En iOS y macOS, esta señal no es fiable si el controlador se encuentra en el modo « PeripheralRole ». En Android, la señal se emite cuando se desconecta el último dispositivo conectado. En el backend BlueZ DBus, se considera que el controlador está desconectado cuando el último cliente que ha accedido a los atributos se ha desconectado.
void QLowEnergyController::discoverServices()
Inicia el proceso de detección de servicios.
El progreso de la detección se indica a través de la señal « serviceDiscovered()». La señal « discoveryFinished()» se emite cuando el proceso ha finalizado.
Si la instancia del controlador no está conectada o si el controlador ya ha realizado el descubrimiento de servicios, esta función no hará nada.
Nota: Algunas plataformas almacenan en caché internamente la lista de servicios de un dispositivo que se ha detectado anteriormente. Esto puede suponer un problema si el dispositivo remoto ha modificado su lista de servicios o su árbol de inclusión. Si este comportamiento supone un problema, la mejor solución es desactivar temporalmente el Bluetooth. Esto provoca un reinicio de los datos de la caché. Actualmente, Android presenta este comportamiento de caché.
[signal] void QLowEnergyController::discoveryFinished()
Esta señal se emite cuando finaliza el proceso de detección de servicios en curso. La señal no se emite si el proceso de detección finaliza con un error.
Esta señal solo se puede emitir si el controlador se encuentra en el estado « CentralRole ».
Véanse también discoverServices() y error().
QLowEnergyController::Error QLowEnergyController::error() const
Devuelve el último error que se haya producido o un objeto de tipo « NoError ».
[signal, since 6.2] void QLowEnergyController::errorOccurred(QLowEnergyController::Error newError)
Esta señal se emite cuando se produce un error. El parámetro « newError » describe el error que se ha producido.
Esta función se introdujo en Qt 6.2.
Véase también « error()» y « errorString()».
QString QLowEnergyController::errorString() const
Devuelve una representación textual del último error producido. La cadena está traducida.
QBluetoothAddress QLowEnergyController::localAddress() const
Devuelve la dirección del adaptador Bluetooth local que se está utilizando para la comunicación.
Si se solicitó a esta instancia de clase que utilizara el adaptador predeterminado, pero no existía ningún adaptador predeterminado al crear dicha instancia, el objeto ` QBluetoothAddress ` devuelto será `null`.
Véase también QBluetoothAddress::isNull().
[since 6.2] int QLowEnergyController::mtu() const
Devuelve el tamaño de la MTU.
Durante el establecimiento de la conexión, se negocia el tamaño de la MTU de ATT. Este método proporciona el resultado de dicha negociación. Se puede utilizar para optimizar el tamaño de los paquetes en determinadas situaciones. La cantidad máxima de datos que se puede transferir en un solo paquete es de mtu-3 bytes. Se requieren 3 bytes para la cabecera del protocolo ATT.
Antes del establecimiento de la conexión y de la negociación del MTU, se devolverá el valor por defecto de 23.
No todas las plataformas revelan el valor de MTU. En esas plataformas (por ejemplo, Linux), esta función siempre devuelve « -1 ».
Si el controlador se encuentra en PeripheralRole, es posible que haya varios dispositivos centrales conectados a él. En esos casos, esta función devuelve el MTU de la última conexión que se negoció.
Esta función se introdujo en Qt 6.2.
[signal] void QLowEnergyController::mtuChanged(int mtu)
Esta señal se emite como resultado de un cambio de MTU realizado con éxito. « mtu » representa el nuevo valor.
Nota: Si el controlador se encuentra en el estado « PeripheralRole », el valor de MTU se negocia de forma individual para cada cliente o dispositivo central. Por lo tanto, esta señal puede emitirse varias veces seguidas para uno o varios dispositivos.
Véase también mtu().
[since 6.5] void QLowEnergyController::readRssi()
La función `readRssi()` lee el RSSI (indicador de intensidad de la señal recibida) de un dispositivo remoto conectado. Si la lectura se ha realizado correctamente, el valor del RSSI se comunica mediante la señal ` rssiRead()`.
Nota: Antes de llamar a readRssi(), este controlador debe estar conectado a un periférico. Este controlador debe crearse mediante createCentral().
Nota: En casode que el backend de Bluetooth que estés utilizando no admita la lectura del RSSI, se emitirá la señal errorOccurred() con un código de error QLowEnergyController::RssiReadError. Por el momento, las plataformas que admiten la lectura del RSSI son Android, iOS y macOS.
Esta función se introdujo en Qt 6.5.
Véanse también rssiRead(), connectToDevice(), state(), createCentral() y errorOccurred().
QBluetoothAddress QLowEnergyController::remoteAddress() const
Devuelve la dirección del dispositivo Bluetooth Low Energy remoto.
En el caso de un controlador de la clase « CentralRole », este valor será siempre el que se pasó al crear el objeto controlador. En el caso de un controlador de la clase « PeripheralRole », este valor es una de las direcciones de los dispositivos cliente conectados actualmente. Esta dirección no será válida si el controlador no se encuentra actualmente en la clase « ConnectedState ».
QLowEnergyController::RemoteAddressType QLowEnergyController::remoteAddressType() const
Devuelve el tipo de ` remoteAddress()`. Por defecto, este valor se inicializa como ` PublicAddress`.
Véase también setRemoteAddressType().
QBluetoothUuid QLowEnergyController::remoteDeviceUuid() const
Devuelve el identificador único del dispositivo Bluetooth Low Energy remoto.
En macOS/iOS/tvOS, CoreBluetooth no expone ni acepta direcciones de hardware para dispositivos LE; en su lugar, se espera que los desarrolladores utilicen UUID únicos de 128 bits, generados por CoreBluetooth. Estos UUID permanecerán constantes para un mismo par central <-> periférico y los utilizamos al conectarnos a un dispositivo remoto. Para un controlador del tipo « CentralRole », este valor será siempre el que se pasó al crear el objeto controlador. Para un controlador del tipo « PeripheralRole », este valor no es válido.
QString QLowEnergyController::remoteName() const
Devuelve el nombre del dispositivo Bluetooth Low Energy remoto, si el controlador se encuentra en el modo « CentralRole ». En caso contrario, el resultado no está especificado.
void QLowEnergyController::requestConnectionUpdate(const QLowEnergyConnectionParameters ¶meters)
Solicita al controlador que actualice la conexión según parameters. Si la solicitud se realiza correctamente, se emitirá la señal connectionUpdated() con los nuevos parámetros reales. Consulte la clase QLowEnergyConnectionParameters para obtener más información sobre los parámetros de conexión.
Android solo permite de forma indirecta el ajuste de este conjunto de parámetros. Los parámetros de conexión se dividen en tres categorías (prioridad alta, baja y equilibrada). Cada categoría implica un conjunto preconfigurado de valores para QLowEnergyConnectionParameters::minimumInterval(), QLowEnergyConnectionParameters::maximumInterval() y QLowEnergyConnectionParameters::latency(). Aunque la solicitud de conexión es una operación asíncrona, Android no proporciona una llamada de retorno que indique el resultado de la solicitud. Se trata de un error reconocido de Android. Debido a este error, Android no emite la señal connectionUpdated().
Nota: Actualmente , esta funcionalidad solo está implementada en el backend del kernel de Linux y en Android.
Véase también ` connectionUpdated()`.
QLowEnergyController::Role QLowEnergyController::role() const
Devuelve el rol que tiene este objeto controlador.
El rol se determina al crear una instancia de ` QLowEnergyController ` mediante ` createCentral()` o ` createPeripheral()`.
[signal, since 6.5] void QLowEnergyController::rssiRead(qint16 rssi)
Esta señal se emite tras leer correctamente el RSSI (indicador de intensidad de señal recibida) de un dispositivo remoto conectado. El parámetro « rssi » representa el nuevo valor.
Esta función se introdujo en Qt 6.5.
Véase también readRssi().
[signal] void QLowEnergyController::serviceDiscovered(const QBluetoothUuid &newService)
Esta señal se emite cada vez que se detecta un nuevo servicio. El parámetro « newService » contiene el UUID del servicio detectado.
Esta señal solo puede emitirse si el controlador se encuentra en el estado « CentralRole ».
Véase también discoverServices() y discoveryFinished().
QList<QBluetoothUuid> QLowEnergyController::services() const
Devuelve la lista de servicios que ofrece el dispositivo remoto, si el controlador se encuentra en el estado « CentralRole ». En caso contrario, el resultado no está especificado.
La lista contiene todos los servicios primarios y secundarios.
Véase también createServiceObject().
void QLowEnergyController::setRemoteAddressType(QLowEnergyController::RemoteAddressType type)
Establece la dirección remota type. El tipo es obligatorio para conectarse al dispositivo Bluetooth Low Energy remoto.
Solo es necesario configurar este atributo en sistemas Linux/BlueZ con núcleos de Linux antiguos (v3.3 o inferior), o si no se ha establecido CAP_NET_ADMIN para el ejecutable. El valor por defecto del atributo es RandomAddress.
Nota: El resto de plataformas gestionan este indicador de forma transparente, por lo que las aplicaciones pueden ignorarlo por completo. En Linux, BlueZ no expone directamente el indicador de tipo de dirección, aunque algunos casos de uso sí requieren esta información. La única forma de detectar el indicador es a través de la API de gestión de Bluetooth del núcleo de Linux (se requiere la versión 3.4 o superior del núcleo). Sin embargo, esta API requiere los derechos de CAP_NET_ADMIN. Si el proceso local QtBluetooth tiene este derecho activado, QtBluetooth utilizará la API. Esto supone que se ha utilizado QBluetoothDeviceDiscoveryAgent antes de llamar a QLowEnergyController::connectToDevice().
Véase también remoteAddressType().
void QLowEnergyController::startAdvertising(const QLowEnergyAdvertisingParameters ¶meters, const QLowEnergyAdvertisingData &advertisingData, const QLowEnergyAdvertisingData &scanResponseData = QLowEnergyAdvertisingData())
Inicia la difusión de los datos indicados en advertisingData y scanResponseData, utilizando los parámetros establecidos en parameters. El controlador debe encontrarse en PeripheralRole. Si parameters indica que la difusión debe permitir conexiones, esta función también comienza a escuchar las conexiones entrantes de los clientes.
No es necesario proporcionar scanResponseData, ya que no es aplicable para determinadas configuraciones de parameters. advertisingData y scanResponseData están limitados a 31 bytes de datos de usuario. Si, por ejemplo, se añaden varios UUID de 128 bits a advertisingData, es posible que los paquetes anunciados no contengan todos los UUID. El límite existente puede haber provocado el truncamiento de los UUID. En tales casos, se puede utilizar scanResponseData para obtener información adicional.
En el backend DBus de BlueZ, BlueZ decide si se utilizan datos en una respuesta de exploración y cuáles. Por lo tanto, se recomienda configurar todos los datos de anuncio en el parámetro principal advertisingData. Si se configuran tanto los datos de anuncio como los de respuesta de exploración, se da prioridad a los datos de respuesta de exploración.
Si este objeto no se encuentra actualmente en UnconnectedState, no ocurre nada.
Véase también stopAdvertising().
QLowEnergyController::ControllerState QLowEnergyController::state() const
Devuelve el estado actual del controlador.
Véase también ` stateChanged()`.
[signal] void QLowEnergyController::stateChanged(QLowEnergyController::ControllerState state)
Esta señal se emite cuando cambia el estado del controlador. El nuevo state también se puede consultar mediante state().
Véase también state().
void QLowEnergyController::stopAdvertising()
Detiene la publicidad si este objeto se encuentra actualmente en estado de publicidad.
Para que esta función funcione, el controlador debe estar en el estado « PeripheralRole ». No invalida los servicios que se hayan añadido previamente mediante addService().
Véase también startAdvertising().
© 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.