En esta página

Cambios en Qt Bluetooth

Qt 6 son el resultado de un esfuerzo deliberado por hacer que el marco sea más eficiente y fácil de usar.

Intentamos mantener la compatibilidad binaria y de código fuente para todas las API públicas en cada versión. Sin embargo, algunos cambios eran inevitables en nuestro esfuerzo por hacer de Qt un marco de trabajo mejor.

En este tema resumimos esos cambios en QtBluetooth y ofrecemos orientación para gestionarlos.

General

  • Se ha eliminado qbluetoothglobal.h. qtbluetoothglobal.h es el archivo de cabecera oficial con la misma finalidad.
  • Todas las referencias a QVector se han sustituido por QList.
  • Se ha eliminado el backend de Win32. No habrá ningún backend de Bluetooth operativo cuando Qt se compile con mingw.
  • Dado que ahora solo hay un backend para Windows, se ha eliminado la categoría de registro qt.bluetooth.winrt. Los mensajes de registro correspondientes se encuentran ahora en qt.bluetooth.windows.

Espacio de nombres QBluetooth

Las enumeraciones « QBluetooth::Security » y « QBluetooth::AttAccessConstraint » se han cambiado a enumeraciones con ámbito para mejorar la seguridad de tipos.

QBluetoothDeviceDiscoveryAgent

Se han eliminado la propiedad `QBluetoothDeviceDiscoveryAgent::inquiryType` y los métodos setter/getter y la enumeración relacionados. Este elemento de la API nunca se implementó ni fue compatible.

QBluetoothDeviceInfo

  • manufacturerData() devuelve un ` QMultiHash ` en lugar de un ` QHash`. Desde Qt 6, ` QMultiHash ` ya no deriva de ` QHash`.
  • DataCompleteness se eliminó sin sustitución, ya que los elementos de la API relacionados ya no tenían utilidad
  • setServiceUuids(const QList<QBluetoothUuid>, DataCompleteness) se ha sustituido por setServiceUuids(const QList<QBluetoothUuid> &uuids)
  • La función const serviceUuidsCompleteness() de DataCompleteness se ha eliminado sin sustitución.
  • QList<QBluetoothUuid> serviceUuids(DataCompleteness *completeness = nullptr) const se ha sustituido por QList<QBluetoothUuid> serviceUuids() const.

QBluetoothLocalDevice

Se ha eliminado la API relacionada con el agente de emparejamiento sin sustitución. Esto incluye pairingConfirmation(bool), pairingDisplayPinCode(..) y pairingDisplayConfirmation(..). Excepto en Android y BlueZ 4, nunca hubo una implementación para ello. La compatibilidad con BlueZ 4 se eliminó en Qt 6 y la implementación de Android requería el privilegio BLUETOOTH_PRIVILEGED, imposible de obtener, al menos para algunas partes del código.

QLowEnergyService

Se han renombrado los valores de la enumeración ServiceState:

Este cambio se produce ante la posibilidad de que, en el futuro, la detección de servicios pase a ser un paso opcional.

QBluetoothUuid

Las enumeraciones « ProtocolUuid », « ServiceClassUuid », « CharacteristicType » y « DescriptorType » son ahora enumeraciones con ámbito. El uso de los elementos de la enumeración debe adaptarse en el código del usuario.

QLowEnergyController

  • Se han eliminado los constructores y las funciones create*() existentes que tenían parámetros remotos de tipo « QBluetoothAddress ». « QBluetoothAddress » no es suficiente para identificar dispositivos remotos en sistemas Apple. Se requieren UUID para «nombrar» los dispositivos. Esto solo se puede cumplir mediante « QBluetoothDeviceInfo ».
  • Los constructores QLowEnergyController restantes se han convertido en privados. Se deben utilizar las funciones createPeripheral() y createCentral() para obtener instancias de QLowEnergyController.

QLowEnergyCharacteristic

  • Se ha introducido el nuevo método clientCharacteristicConfiguration() para obtener fácilmente el descriptor de configuración de características del cliente.
  • Se han introducido las constantes CCCDDisable, CCCDEnableNotification y CCCDEnableIndication, que contienen los valores posibles para el descriptor de configuración de características del cliente.
  • El método `handle()` ya no forma parte de las interfaces públicas de Bluetooth LE. Su función como identificador de características ha sido sustituida. Las propias instancias de ` QLowEnergyCharacteristic ` sirven como identificador.

QLowEnergyDescriptor

El método handle() ya no forma parte de las interfaces públicas de Bluetooth LE. Su función como identificador de descriptores ha sido sustituida. Las propias instancias de ` QLowEnergyDescriptor ` sirven como identificador.

QBluetoothTransferManager

Se han eliminado QBluetoothTransferManager, QBluetoothTransferRequest y QBluetoothTransferReply sin sustitución.

QBluetoothSocket

QBluetoothSocket::SocketState y QBluetoothSocket::SocketError son ahora enumeraciones con ámbito. El uso de los elementos de la enumeración debe adaptarse en el código del usuario.

Interfaz QML

Se ha eliminado la interfaz QML, ya que no se recomienda la programación de sockets mediante QML. Se han eliminado sin sustitución QDeclarativeBluetoothService, QDeclarativeBluetoothSocket y QDeclarativeBluetoothDiscoveryModel (en QML: BluetoothService, BluetoothSocket y BluetoothDiscoveryModel).

Señales «error»

Las señales «error» de QBluetoothDeviceDiscoveryAgent, QBluetoothLocalDevice, QBluetoothServer, QBluetoothServiceDiscoveryAgent, QBluetoothSocket, QLowEnergyController y QLowEnergyService han pasado a denominarse «errorOccurred» para eliminar ambigüedades entre la señal «error» y el getter «error».

© 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.