QBluetoothDeviceDiscoveryAgent Class

Documentación de las funciones miembro

[explicit] QBluetoothDeviceDiscoveryAgent::QBluetoothDeviceDiscoveryAgent(QObject *parent = nullptr)

Construye un nuevo agente de descubrimiento de dispositivos Bluetooth con el padre parent.

[explicit] QBluetoothDeviceDiscoveryAgent::QBluetoothDeviceDiscoveryAgent(const QBluetoothAddress &deviceAdapter, QObject *parent = nullptr)

Construye un nuevo agente de descubrimiento de dispositivos Bluetooth con parent.

Utiliza deviceAdapter para la búsqueda de dispositivos. Si deviceAdapter se construye por defecto el objeto QBluetoothDeviceDiscoveryAgent resultante utilizará el adaptador Bluetooth local por defecto.

Si se especifica un deviceAdapter que no es un adaptador local error() se establecerá en InvalidBluetoothAdapterError. Por lo tanto se recomienda comprobar el indicador de error inmediatamente después de utilizar este constructor.

Véase también error().

[virtual noexcept] QBluetoothDeviceDiscoveryAgent::~QBluetoothDeviceDiscoveryAgent()

Destructor para ~QBluetoothDeviceDiscoveryAgent()

[signal] void QBluetoothDeviceDiscoveryAgent::canceled()

Esta señal se emite cuando se aborta el descubrimiento de dispositivos mediante una llamada a stop().

[signal] void QBluetoothDeviceDiscoveryAgent::deviceDiscovered(const QBluetoothDeviceInfo &info)

Esta señal se emite cuando se descubre el dispositivo Bluetooth descrito por info.

La señal se emite en cuanto se ha recopilado la información más importante del dispositivo. Sin embargo, mientras no se emita la señal finished(), la recopilación de información continúa incluso para los dispositivos ya descubiertos. Esto es especialmente cierto para la información sobre la intensidad de la señal (RSSI) y las actualizaciones de datos del fabricante. Si el caso de uso requiere actualizaciones continuas de datos del fabricante o RSSI, es aconsejable recuperar la información del dispositivo a través de discoveredDevices() una vez finalizado el descubrimiento o escuchar la señal deviceUpdated().

Si lowEnergyDiscoveryTimeout() es mayor que 0, la señal sólo se emite cuando cambia al menos un atributo de info. Esto refleja el deseo de recibir actualizaciones a medida que se dispone de información más precisa. La excepción a este comportamiento es el caso en que lowEnergyDiscoveryTimeout se establece en 0. Un tiempo de espera de 0 expresa el deseo de controlar la aparición y desaparición de dispositivos de Baja Energía a lo largo del tiempo. Bajo esta condición, la señal deviceDiscovered() se emite incluso si info no ha cambiado desde la última emisión de la señal.

Véase también QBluetoothDeviceInfo::rssi() y lowEnergyDiscoveryTimeout().

[signal] void QBluetoothDeviceDiscoveryAgent::deviceUpdated(const QBluetoothDeviceInfo &info, QBluetoothDeviceInfo::Fields updatedFields)

Esta señal se emite cuando el agente recibe información adicional sobre el dispositivo Bluetooth descrito por info. Las banderas updatedFields indican qué información se ha actualizado.

Durante el descubrimiento, alguna información puede cambiar dinámicamente, como signal strength y manufacturerData. Esta señal le informa de que si su aplicación está mostrando estos datos, puede actualizarlos, en lugar de esperar a que el descubrimiento haya finalizado.

Véase también QBluetoothDeviceInfo::rssi() y lowEnergyDiscoveryTimeout().

QList<QBluetoothDeviceInfo> QBluetoothDeviceDiscoveryAgent::discoveredDevices() const

Devuelve una lista de todos los dispositivos Bluetooth descubiertos.

QBluetoothDeviceDiscoveryAgent::Error QBluetoothDeviceDiscoveryAgent::error() const

Devuelve el último error.

Los posibles errores anteriores se borran al reiniciar la detección.

[signal, since 6.2] void QBluetoothDeviceDiscoveryAgent::errorOccurred(QBluetoothDeviceDiscoveryAgent::Error error)

Esta señal se emite cuando se produce un error durante el descubrimiento de dispositivos Bluetooth. El parámetro error describe el error que se ha producido.

Esta función se introdujo en Qt 6.2.

Véase también error() y errorString().

QString QBluetoothDeviceDiscoveryAgent::errorString() const

Devuelve una descripción legible por humanos del último error.

Véase también error() y errorOccurred().

[signal] void QBluetoothDeviceDiscoveryAgent::finished()

Esta señal se emite cuando finaliza el descubrimiento de dispositivos Bluetooth. La señal no se emitirá si el descubrimiento del dispositivo finaliza con un error.

bool QBluetoothDeviceDiscoveryAgent::isActive() const

Devuelve true si el agente está descubriendo dispositivos Bluetooth, en caso contrario devuelve false.

int QBluetoothDeviceDiscoveryAgent::lowEnergyDiscoveryTimeout() const

Devuelve un tiempo de espera en milisegundos que se aplica a la búsqueda de dispositivos Bluetooth Low Energy. Un valor de -1 implica que la plataforma no admite esta propiedad y no se puede ajustar el tiempo de espera para la búsqueda de dispositivos. Un valor de retorno de 0 implica una búsqueda interminable que debe detenerse manualmente mediante stop().

Véase también setLowEnergyDiscoveryTimeout().

void QBluetoothDeviceDiscoveryAgent::setLowEnergyDiscoveryTimeout(int timeout)

Establece el tiempo máximo de búsqueda de dispositivos Bluetooth Low Energy en timeout en milisegundos. Si timeout es 0 el descubrimiento se ejecuta hasta que se llama a stop().

Esto refleja el hecho de que el proceso de descubrimiento de dispositivos Bluetooth Low Energy es mayoritariamente abierto. La plataforma sigue buscando más dispositivos hasta que la búsqueda se detiene manualmente. El tiempo de espera garantiza que la búsqueda se interrumpa después de timeout milisegundos. Por supuesto, todavía es posible abortar manualmente el descubrimiento llamando a stop().

El nuevo valor del tiempo de espera no surte efecto hasta que se reinicia la búsqueda de dispositivos. Además, el tiempo de espera no afecta a la búsqueda clásica de dispositivos Bluetooth. Dependiendo de la plataforma, la búsqueda clásica puede añadir más tiempo al proceso total de descubrimiento más allá de timeout.

Para un descubrimiento fiable de Bluetooth Low Energy, utilice al menos 40000 milisegundos.

Véase también lowEnergyDiscoveryTimeout().

[slot] void QBluetoothDeviceDiscoveryAgent::start()

Inicia el descubrimiento de dispositivos Bluetooth, si aún no se ha iniciado.

La señal deviceDiscovered() se emite a medida que se descubre cada dispositivo. La señal finished() se emite una vez finalizado el descubrimiento de dispositivos. El descubrimiento utiliza el conjunto máximo de métodos de descubrimiento soportados en la plataforma.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        bluetoothDeviceDiscoveryAgent, qOverload<>(&QBluetoothDeviceDiscoveryAgent::start));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        bluetoothDeviceDiscoveryAgent, [receiver = bluetoothDeviceDiscoveryAgent]() { receiver->start(); });

Véase también supportedDiscoveryMethods().

[slot] void QBluetoothDeviceDiscoveryAgent::start(QBluetoothDeviceDiscoveryAgent::DiscoveryMethods methods)

Inicia la detección de dispositivos Bluetooth, si aún no se ha iniciado y se admite la dirección methods proporcionada. El descubrimiento methods limita el alcance de la búsqueda de dispositivos. Por ejemplo, si el servicio o dispositivo de destino es un dispositivo Bluetooth Low Energy, esta función podría utilizarse para limitar la búsqueda a dispositivos Bluetooth Low Energy y, de este modo, reducir significativamente el tiempo de descubrimiento.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        bluetoothDeviceDiscoveryAgent, qOverload(&QBluetoothDeviceDiscoveryAgent::start));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        bluetoothDeviceDiscoveryAgent, [receiver = bluetoothDeviceDiscoveryAgent](QBluetoothDeviceDiscoveryAgent::DiscoveryMethods methods) { receiver->start(methods); });

[slot] void QBluetoothDeviceDiscoveryAgent::stop()

Detiene el descubrimiento de dispositivos Bluetooth. La señal cancel() se emite una vez cancelado el descubrimiento de dispositivos. start() puede llamarse antes de recibir la señal de cancelación. Una vez que se ha llamado a start(), la señal de cancelación del descubrimiento anterior se descartará.

[static] QBluetoothDeviceDiscoveryAgent::DiscoveryMethods QBluetoothDeviceDiscoveryAgent::supportedDiscoveryMethods()

Esta función devuelve los métodos de descubrimiento admitidos por la plataforma actual. Se puede utilizar para limitar el alcance del descubrimiento de dispositivos.