QBluetoothServiceDiscoveryAgent Class

void MyClass::startServiceDiscovery() { // Créer un agent de découverte et se connecter à ses signaux   QBluetoothServiceDiscoveryAgent *discoveryAgent = new QBluetoothServiceDiscoveryAgent(this) ; connect(discoveryAgent, SIGNAL(serviceDiscovered(QBluetoothServiceInfo)), this, SLOT(serviceDiscovered(QBluetoothServiceInfo))) ; // Démarrer une découverte discoveryAgent->start() ; //...}// Dans votre slot local, lisez les informations sur les appareils trouvésvoid MyClass::serviceDiscovered(const QBluetoothServiceInfo &service){
    qDebug() << "Found new service:" << service.serviceName()
            << '('<< service.device().address().toString()<< ')'; }

Documentation des fonctions membres

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

Construit un nouveau QBluetoothServiceDiscoveryAgent avec parent. La recherche est effectuée via l'adaptateur Bluetooth local par défaut.

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

Construit un nouveau QBluetoothServiceDiscoveryAgent pour deviceAdapter et avec parent.

Il utilise deviceAdapter pour la recherche de services. Si deviceAdapter est construit par défaut, l'objet QBluetoothServiceDiscoveryAgent résultant utilisera l'adaptateur Bluetooth local par défaut.

Si un adaptateur deviceAdapter qui n'est pas un adaptateur local est spécifié, error() prendra la valeur InvalidBluetoothAdapterError. Il est donc recommandé de tester le drapeau d'erreur immédiatement après l'utilisation de ce constructeur.

Voir également error().

[virtual noexcept] QBluetoothServiceDiscoveryAgent::~QBluetoothServiceDiscoveryAgent()

Destructeur pour QBluetoothServiceDiscoveryAgent

[signal] void QBluetoothServiceDiscoveryAgent::canceled()

Ce signal est déclenché lorsque la découverte du service a été annulée par un appel à stop().

[slot] void QBluetoothServiceDiscoveryAgent::clear()

Efface les résultats des recherches de services précédentes et réinitialise uuidFilter(). Cette fonction ne fait rien pendant une recherche de service en cours (voir isActive()).

Voir aussi discoveredServices().

QList<QBluetoothServiceInfo> QBluetoothServiceDiscoveryAgent::discoveredServices() const

Renvoie la liste de tous les services découverts.

Cette liste de services accumule les services nouvellement découverts à la suite de plusieurs appels à start(). À moins que clear() ne soit appelé, la taille de la liste ne peut pas diminuer. Cela signifie que si un périphérique Bluetooth distant se déplace hors de portée entre deux appels ultérieurs à start(), la liste peut contenir des entrées périmées.

Voir également clear().

QBluetoothServiceDiscoveryAgent::Error QBluetoothServiceDiscoveryAgent::error() const

Renvoie le type d'erreur qui s'est produite en dernier. Si la recherche de services est effectuée pour un seul remoteAddress(), il renverra les erreurs qui se sont produites lors de la recherche de services sur ce dispositif. Si l'option remoteAddress() n'est pas activée et que les appareils sont découverts par un balayage, les erreurs survenues lors de la découverte de services sur des appareils individuels ne sont pas enregistrées et aucun signal n'est émis. Dans ce cas, les erreurs sont assez normales car certains appareils peuvent ne pas répondre à la découverte ou ne plus être à portée. Ces erreurs sont supprimées. Si aucun service n'est renvoyé, on peut supposer qu'aucun service n'a pu être découvert.

Les éventuelles erreurs précédentes sont effacées lors du redémarrage de la découverte.

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

Ce signal est émis lorsqu'une erreur se produit sur error. Le paramètre error décrit l'erreur qui s'est produite.

Cette fonction a été introduite dans Qt 6.2.

QString QBluetoothServiceDiscoveryAgent::errorString() const

Renvoie une description lisible par l'homme de la dernière erreur survenue lors de la découverte du service.

Voir aussi error() et errorOccurred().

[signal] void QBluetoothServiceDiscoveryAgent::finished()

Ce signal est émis lorsque la découverte du service Bluetooth est terminée.

Contrairement au signal QBluetoothDeviceDiscoveryAgent::finished(), ce signal est émis même en cas d'erreur lors de la découverte du service. Il est donc recommandé de vérifier le signal errorOccurred() pour évaluer le succès de la découverte du service.

bool QBluetoothServiceDiscoveryAgent::isActive() const

Renvoie true si la recherche de services est actuellement active ; sinon, renvoie false. Une découverte active peut être arrêtée en appelant stop().

QBluetoothAddress QBluetoothServiceDiscoveryAgent::remoteAddress() const

Renvoie l'adresse du dispositif distant. Si setRemoteAddress() n'est pas appelé, la fonction renvoie une adresse construite par défaut : QBluetoothAddress.

Voir aussi setRemoteAddress().

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

Ce signal est émis lorsque le service Bluetooth décrit par info est découvert.

Voir aussi QBluetoothDeviceInfo::coreConfigurations().

bool QBluetoothServiceDiscoveryAgent::setRemoteAddress(const QBluetoothAddress &address)

Définit l'adresse de l'appareil distant à address. Si address est construit par défaut, les services seront découverts sur tous les appareils Bluetooth pouvant être contactés. Une nouvelle adresse distante ne peut être définie que lorsqu'il n'y a pas de découverte de services en cours ; sinon, cette fonction renvoie un faux.

Sur certaines plateformes, la découverte de services peut conduire à des demandes d'appairage. Il n'est donc pas recommandé d'effectuer des recherches de services sur tous les appareils. Cette fonction peut être utilisée pour restreindre la recherche de services à un appareil particulier.

Voir aussi remoteAddress().

void QBluetoothServiceDiscoveryAgent::setUuidFilter(const QBluetoothUuid &uuid)

Il s'agit d'une fonction membre surchargée, fournie pour des raisons de commodité.

Fixe le filtre UUID à une liste contenant l'élément unique uuid. La correspondance s'applique aux attributs ServiceId et ServiceClassIds du service.

Voir aussi uuidFilter().

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

Définit le filtre UUID à uuids. Seuls les services correspondant aux UUID de uuids seront renvoyés. La correspondance s'applique aux attributs ServiceId et ServiceClassIds du service.

Une liste d'UUID vide est équivalente à une liste contenant uniquement QBluetoothUuid::ServiceClassUuid::PublicBrowseGroup.

Voir aussi uuidFilter().

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

Démarre la découverte des services. mode spécifie le type de découverte des services à effectuer.

Sur certaines plates-formes, la découverte de l'appareil peut conduire à des demandes d'appariement.

Voir également DiscoveryMode.

[slot] void QBluetoothServiceDiscoveryAgent::stop()

Arrête le processus de découverte des services. Le signal canceled() sera émis une fois la recherche arrêtée.

QList<QBluetoothUuid> QBluetoothServiceDiscoveryAgent::uuidFilter() const

Renvoie le filtre UUID.

Voir aussi setUuidFilter().