QBluetoothDeviceDiscoveryAgent Class

Documentation des fonctions membres

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

Crée un nouvel agent de détection de périphériques Bluetooth dont le parent est parent.

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

Crée un nouvel agent de détection de périphériques Bluetooth à l'aide de ` parent`.

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

Si l'on spécifie un deviceAdapter qui n'est pas un adaptateur local, error() sera défini sur InvalidBluetoothAdapterError. Il est donc recommandé de vérifier l'indicateur d'erreur immédiatement après l'utilisation de ce constructeur.

Voir également error().

[virtual noexcept] QBluetoothDeviceDiscoveryAgent::~QBluetoothDeviceDiscoveryAgent()

Destructeur pour ~QBluetoothDeviceDiscoveryAgent()

[signal] void QBluetoothDeviceDiscoveryAgent::canceled()

Ce signal est émis lorsque la détection des périphériques est interrompue par un appel à la fonction ` stop()`.

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

Ce signal est émis lorsque l'appareil Bluetooth décrit par ` info ` est détecté.

Le signal est émis dès que les informations les plus importantes concernant l’appareil ont été collectées. Cependant, tant que le signal finished() n’a pas été émis, la collecte d’informations se poursuit, même pour les appareils déjà détectés. Cela vaut en particulier pour les informations relatives à la puissance du signal (RSSI) et les mises à jour des données du fabricant. Si le cas d’utilisation nécessite des mises à jour continues des données du fabricant ou de la RSSI, il est conseillé de récupérer les informations sur le périphérique via ` discoveredDevices()` une fois la détection terminée ou d’écouter le signal ` deviceUpdated()`.

Si la valeur de ` lowEnergyDiscoveryTimeout()` est supérieure à 0, le signal n’est émis que lorsqu’au moins un attribut de ` info ` change. Cela reflète le souhait de recevoir des mises à jour à mesure que des informations plus précises deviennent disponibles. La seule exception à ce comportement se produit lorsque ` lowEnergyDiscoveryTimeout ` est défini sur ` 0`. Un délai d’expiration de ` 0 ` indique la volonté de surveiller l’apparition et la disparition des périphériques Low Energy au fil du temps. Dans ces conditions, le signal `deviceDiscovered()` est émis même si ` info ` n’a pas changé depuis la dernière émission du signal.

Voir également QBluetoothDeviceInfo::rssi() et lowEnergyDiscoveryTimeout().

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

Ce signal est émis lorsque l'agent reçoit des informations supplémentaires concernant le périphérique Bluetooth décrit par info. Les indicateurs updatedFields indiquent quelles informations ont été mises à jour.

Au cours de la découverte, certaines informations peuvent évoluer de manière dynamique, telles que signal strength et manufacturerData. Ce signal vous indique que si votre application affiche ces données, elle peut les mettre à jour sans attendre la fin de la découverte.

Voir également QBluetoothDeviceInfo::rssi() et lowEnergyDiscoveryTimeout().

QList<QBluetoothDeviceInfo> QBluetoothDeviceDiscoveryAgent::discoveredDevices() const

Renvoie une liste de tous les périphériques Bluetooth détectés.

QBluetoothDeviceDiscoveryAgent::Error QBluetoothDeviceDiscoveryAgent::error() const

Renvoie la dernière erreur.

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

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

Ce signal est émis lorsqu'une erreur « error » se produit lors de la détection d'un périphérique Bluetooth. Le paramètre « error » décrit l'erreur qui s'est produite.

Cette fonction a été introduite dans Qt 6.2.

Voir également error() et errorString().

QString QBluetoothDeviceDiscoveryAgent::errorString() const

Renvoie une description lisible par l'utilisateur de la dernière erreur.

Voir également error() et errorOccurred().

[signal] void QBluetoothDeviceDiscoveryAgent::finished()

Ce signal est émis lorsque la détection des appareils Bluetooth est terminée. Il n'est pas émis si la détection des appareils se termine par une erreur.

bool QBluetoothDeviceDiscoveryAgent::isActive() const

Renvoie « true » si l'agent est en train de détecter des périphériques Bluetooth ; sinon, renvoie « false ».

int QBluetoothDeviceDiscoveryAgent::lowEnergyDiscoveryTimeout() const

Renvoie un délai d'expiration, exprimé en millisecondes, qui s'applique à la recherche de périphériques Bluetooth Low Energy. La valeur « -1 » indique que la plateforme ne prend pas en charge cette propriété et que le délai d'expiration pour la recherche de périphériques ne peut pas être modifié. La valeur « 0 » implique une recherche sans fin qui doit être interrompue manuellement via la fonction stop().

Voir également setLowEnergyDiscoveryTimeout().

void QBluetoothDeviceDiscoveryAgent::setLowEnergyDiscoveryTimeout(int timeout)

Définit la durée maximale de recherche des appareils Bluetooth Low Energy à timeout en millisecondes. Si timeout est 0, la découverte se poursuit jusqu’à ce que stop() soit appelé.

Cela tient compte du fait que le processus de découverte des appareils Bluetooth Low Energy est généralement illimité dans le temps. La plateforme continue de rechercher d’autres appareils jusqu’à ce que la recherche soit arrêtée manuellement. Le délai d’expiration garantit que la recherche est interrompue après timeout millisecondes. Bien entendu, il est toujours possible d’interrompre manuellement la découverte en appelant stop().

La nouvelle valeur de délai d'expiration ne prend effet qu'au redémarrage de la recherche de périphériques. De plus, ce délai n'affecte pas la recherche classique de périphériques Bluetooth. Selon la plateforme, la recherche classique peut allonger la durée totale du processus de découverte au-delà de timeout.

Pour une découverte Bluetooth Low Energy fiable, utilisez au moins 40 000 millisecondes.

Voir également lowEnergyDiscoveryTimeout().

[slot] void QBluetoothDeviceDiscoveryAgent::start()

Lance la détection des appareils Bluetooth, si elle n'est pas déjà en cours.

Le signal « deviceDiscovered() » est émis à chaque fois qu’un appareil est détecté. Le signal « finished() » est émis une fois la détection des appareils terminée. La détection utilise l’ensemble maximal des méthodes de détection prises en charge sur la plateforme.

// 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(); });

Voir également ` supportedDiscoveryMethods()`.

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

Lance la détection des périphériques Bluetooth, si celle-ci n'est pas déjà en cours et si les methods s fournies sont prises en charge. Les methods s de détection limitent la portée de la recherche de périphériques. Par exemple, si le service ou le périphérique cible est un périphérique Bluetooth Low Energy, cette fonction peut être utilisée pour limiter la recherche aux périphériques Bluetooth Low Energy, ce qui réduit considérablement le temps de détection.

// 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()

Arrête la recherche d'appareils Bluetooth. Le signal `cancel()` est émis dès que la recherche d'appareils est annulée. La fonction ` start()` peut être appelée avant la réception du signal `cancel()`. Une fois que la fonction ` start()` a été appelée, le signal `cancel()` issu de la recherche précédente sera ignoré.

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

Cette fonction renvoie les méthodes de détection prises en charge par la plateforme actuelle. Elle permet de limiter la portée de la détection des périphériques.