QBluetoothServiceDiscoveryAgent Class

void MyClass::startServiceDiscovery() { // Crear un agente de descubrimiento y conectarse a sus señales   QBluetoothServiceDiscoveryAgent *discoveryAgent = new QBluetoothServiceDiscoveryAgent(this); connect(discoveryAgent, SIGNAL(serviceDiscovered(QBluetoothServiceInfo)), this, SLOT(serviceDiscovered(QBluetoothServiceInfo))); // Iniciar un discoveryAgent->start(); //...}// En su slot local, leer información sobre los dispositivos encontradosvoid MyClass::serviceDiscovered(const QBluetoothServiceInfo &servicio){
    qDebug() << "Found new service:" << service.serviceName()
            << '('<< service.device().address().toString()<< ')'; }

Documentación de las funciones miembro

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

Construye un nuevo QBluetoothServiceDiscoveryAgent con parent. La búsqueda se realiza a través del adaptador Bluetooth local por defecto.

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

Construye un nuevo QBluetoothServiceDiscoveryAgent para deviceAdapter y con parent.

Utiliza deviceAdapter para la búsqueda de servicios. Si deviceAdapter se construye por defecto el objeto QBluetoothServiceDiscoveryAgent 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] QBluetoothServiceDiscoveryAgent::~QBluetoothServiceDiscoveryAgent()

Destructor para QBluetoothServiceDiscoveryAgent

[signal] void QBluetoothServiceDiscoveryAgent::canceled()

Esta señal se activa cuando se cancela el descubrimiento del servicio mediante una llamada a stop().

[slot] void QBluetoothServiceDiscoveryAgent::clear()

Borra los resultados de los descubrimientos de servicios anteriores y reinicia uuidFilter(). Esta función no hace nada durante un descubrimiento de servicio en curso (véase isActive()).

Véase también discoveredServices().

QList<QBluetoothServiceInfo> QBluetoothServiceDiscoveryAgent::discoveredServices() const

Devuelve la lista de todos los servicios descubiertos.

Esta lista de servicios acumula los servicios recién descubiertos a partir de múltiples llamadas a start(). A menos que se llame a clear(), la lista no puede disminuir de tamaño. Esto implica que si un dispositivo Bluetooth remoto sale del alcance entre dos llamadas posteriores a start(), la lista puede contener entradas obsoletas.

Véase también clear().

QBluetoothServiceDiscoveryAgent::Error QBluetoothServiceDiscoveryAgent::error() const

Devuelve el tipo de error que se produjo por última vez. Si el descubrimiento de servicios se realiza para un único remoteAddress() devolverá los errores que se produjeron al intentar descubrir servicios en ese dispositivo. Si no se establece remoteAddress() y los dispositivos se descubren mediante un escaneo, los errores durante el descubrimiento de servicios en dispositivos individuales no se guardan y no se emiten señales. En este caso, los errores son bastante normales, ya que algunos dispositivos pueden no responder al descubrimiento o dejar de estar dentro del alcance. Estos errores se suprimen. Si no se devuelve ningún servicio, se puede asumir que no se ha podido descubrir ningún servicio.

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

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

Esta señal se emite cuando se produce un error. El parámetro error describe el error que se ha producido.

Esta función se introdujo en Qt 6.2.

QString QBluetoothServiceDiscoveryAgent::errorString() const

Devuelve una descripción legible por humanos del último error que se ha producido durante el descubrimiento del servicio.

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

[signal] void QBluetoothServiceDiscoveryAgent::finished()

Esta señal se emite cuando finaliza el descubrimiento del servicio Bluetooth.

A diferencia de la señal QBluetoothDeviceDiscoveryAgent::finished(), esta señal se emitirá incluso cuando se produzca un error durante el descubrimiento del servicio. Por lo tanto, se recomienda comprobar la señal errorOccurred() para evaluar el éxito del descubrimiento del servicio.

bool QBluetoothServiceDiscoveryAgent::isActive() const

Devuelve true si el descubrimiento de servicios está activo; en caso contrario, devuelve false. Un descubrimiento activo puede detenerse llamando a stop().

QBluetoothAddress QBluetoothServiceDiscoveryAgent::remoteAddress() const

Devuelve la dirección del dispositivo remoto. Si no se llama a setRemoteAddress(), la función devolverá una QBluetoothAddress construida por defecto.

Véase también setRemoteAddress().

[signal] void QBluetoothServiceDiscoveryAgent::serviceDiscovered(const QBluetoothServiceInfo &info)

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

Véase también QBluetoothDeviceInfo::coreConfigurations().

bool QBluetoothServiceDiscoveryAgent::setRemoteAddress(const QBluetoothAddress &address)

Establece la dirección del dispositivo remoto en address. Si address se construye por defecto, los servicios se descubrirán en todos los dispositivos Bluetooth contactables. Sólo se puede establecer una nueva dirección remota mientras no haya ningún descubrimiento de servicio en curso; de lo contrario, esta función devuelve false.

En algunas plataformas el descubrimiento de servicios puede llevar a peticiones de emparejamiento. Por lo tanto, no se recomienda realizar descubrimientos de servicio en todos los dispositivos. Esta función puede utilizarse para restringir el descubrimiento de servicios a un dispositivo concreto.

Véase también remoteAddress().

void QBluetoothServiceDiscoveryAgent::setUuidFilter(const QBluetoothUuid &uuid)

Esta es una función miembro sobrecargada, proporcionada por conveniencia.

Establece el filtro UUID en una lista que contiene el único elemento uuid. La coincidencia se aplica a los atributos ServiceId y ServiceClassIds del servicio.

Véase también uuidFilter().

void QBluetoothServiceDiscoveryAgent::setUuidFilter(const QList<QBluetoothUuid> &uuids)

Establece el filtro UUID en uuids. Sólo se devolverán los servicios que coincidan con los UUID de uuids. La coincidencia se aplica a los atributos ServiceId y ServiceClassIds del servicio.

Una lista de UUID vacía equivale a una lista que sólo contenga QBluetoothUuid::ServiceClassUuid::PublicBrowseGroup.

Véase también uuidFilter().

[slot] void QBluetoothServiceDiscoveryAgent::start(QBluetoothServiceDiscoveryAgent::DiscoveryMode mode = MinimalDiscovery)

Inicia la detección de servicios. mode especifica el tipo de detección de servicios que se va a realizar.

En algunas plataformas, el descubrimiento de dispositivos puede dar lugar a solicitudes de emparejamiento.

Véase también DiscoveryMode.

[slot] void QBluetoothServiceDiscoveryAgent::stop()

Detiene el proceso de búsqueda de servicios. La señal canceled() se emitirá una vez que la búsqueda se haya detenido.

QList<QBluetoothUuid> QBluetoothServiceDiscoveryAgent::uuidFilter() const

Devuelve el filtro UUID.

Véase también setUuidFilter().