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)));

    // Lancer une découverte
    discoveryAgent->start();

    //...
}

// Dans votre slot local, lisez les informations concernant les périphériques détectés
void 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)

Crée un nouvel objet `QBluetoothServiceDiscoveryAgent` avec l'adresse parent. La recherche s'effectue via l'adaptateur Bluetooth local par défaut.

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

Crée un nouvel objet QBluetoothServiceDiscoveryAgent pour deviceAdapter et avec parent.

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

Si un deviceAdapter est spécifié qui n'est pas un adaptateur local, error() sera défini sur InvalidBluetoothAdapterError. Il est donc recommandé de vérifier 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 de service a été annulée par un appel à la fonction ` stop()`.

[slot] void QBluetoothServiceDiscoveryAgent::clear()

Efface les résultats des précédentes détections de services et réinitialise la fonction uuidFilter(). Cette fonction n'a aucun effet pendant une détection de service en cours (voir isActive()).

Voir également discoveredServices().

QList<QBluetoothServiceInfo> QBluetoothServiceDiscoveryAgent::discoveredServices() const

Renvoie la liste de tous les services détectés.

Cette liste de services regroupe les services nouvellement détectés à la suite de plusieurs appels à la fonction ` start()`. À moins que la fonction ` clear()` ne soit appelée, la taille de la liste ne peut pas diminuer. Cela signifie que si un appareil Bluetooth distant sort de la zone de couverture entre deux appels consécutifs à la fonction ` start()`, la liste peut contenir des entrées obsolètes.

Voir également clear().

QBluetoothServiceDiscoveryAgent::Error QBluetoothServiceDiscoveryAgent::error() const

Renvoie le type de l'erreur qui s'est produite en dernier. Si la détection des services est effectuée pour un seul appareil ( remoteAddress()), cette fonction renvoie les erreurs survenues lors de la tentative de détection des services sur cet appareil. Si la méthode remoteAddress() n'est pas définie et que les appareils sont détectés par un balayage, les erreurs survenues lors de la détection des services sur chaque appareil ne sont pas enregistrées et aucun signal n'est émis. Dans ce cas, les erreurs sont tout à fait normales, car certains appareils peuvent ne pas répondre à la détection ou ne plus se trouver à portée. Ces erreurs sont ignorées. Si aucun service n’est renvoyé, on peut supposer qu’aucun service n’a pu être détecté.

Les éventuelles erreurs antérieures sont effacées lors du redémarrage de la détection.

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

Ce signal est émis lorsqu'une « error » se produit. 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 compréhensible par l'utilisateur de la dernière erreur survenue lors de la découverte des services.

Voir également error() et errorOccurred().

[signal] void QBluetoothServiceDiscoveryAgent::finished()

Ce signal est émis lorsque la découverte des services Bluetooth est terminée.

Contrairement au signal « QBluetoothDeviceDiscoveryAgent::finished() », ce signal est émis même lorsqu’une erreur s’est produite pendant la recherche de services. Il est donc recommandé de vérifier le signal « errorOccurred() » pour évaluer si la recherche de services a abouti.

bool QBluetoothServiceDiscoveryAgent::isActive() const

Renvoie « true » si la découverte de service est actuellement active ; sinon, renvoie « false ». Une découverte active peut être interrompue en appelant la fonction « stop() ».

QBluetoothAddress QBluetoothServiceDiscoveryAgent::remoteAddress() const

Renvoie l'adresse du périphérique distant. Si la fonction setRemoteAddress() n'est pas appelée, la fonction renvoie un objet QBluetoothAddress initialisé par défaut.

Voir également setRemoteAddress().

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

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

Voir également QBluetoothDeviceInfo::coreConfigurations().

bool QBluetoothServiceDiscoveryAgent::setRemoteAddress(const QBluetoothAddress &address)

Définit l'adresse de l'appareil distant sur address. Si address est construit par défaut, les services seront détectés sur tous les appareils Bluetooth joignables. Une nouvelle adresse distante ne peut être définie que lorsqu'aucune détection de service n'est en cours ; dans le cas contraire, cette fonction renvoie « false ».

Sur certaines plateformes, la détection de services peut entraîner des demandes d’appairage. Il n’est donc pas recommandé d’effectuer une détection de services sur tous les appareils. Cette fonction permet de limiter la détection de services à un appareil particulier.

Voir également remoteAddress().

void QBluetoothServiceDiscoveryAgent::setUuidFilter(const QBluetoothUuid &uuid)

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

Définit le filtre UUID sur une liste contenant un seul élément : uuid. La correspondance s'applique aux attributs ServiceId et ServiceClassIds du service.

Voir également uuidFilter().

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

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

Une liste d'UUID vide équivaut à une liste ne contenant que QBluetoothUuid::ServiceClassUuid::PublicBrowseGroup.

Voir également uuidFilter().

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

Lance la détection des services. Le paramètre « mode » permet de spécifier le type de détection des services à effectuer.

Sur certaines plateformes, la détection des appareils peut entraîner des demandes d'appairage.

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 terminée.

QList<QBluetoothUuid> QBluetoothServiceDiscoveryAgent::uuidFilter() const

Renvoie le filtre UUID.

Voir aussi setUuidFilter().