QBluetoothDeviceDiscoveryAgent Class

Documentation des fonctions membres

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

Construit un nouvel agent de découverte de périphériques Bluetooth avec le parent parent.

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

Construit un nouvel agent de découverte de périphériques Bluetooth avec parent.

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

Si deviceAdapter est spécifié alors qu'il ne s'agit pas d'un adaptateur local, 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] QBluetoothDeviceDiscoveryAgent::~QBluetoothDeviceDiscoveryAgent()

Destructeur pour ~QBluetoothDeviceDiscoveryAgent()

[signal] void QBluetoothDeviceDiscoveryAgent::canceled()

Ce signal est émis lorsque la découverte de l'appareil est interrompue par un appel à stop().

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

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

Le signal est émis dès que les informations les plus importantes sur l'appareil ont été collectées. Toutefois, tant que le signal finished() n'a pas été émis, la collecte d'informations se poursuit, même pour les appareils déjà découverts. Cela est particulièrement vrai pour les informations sur 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 des RSSI, il est conseillé de récupérer les informations sur l'appareil via discoveredDevices() une fois la découverte terminée ou d'écouter le signal deviceUpdated().

Si lowEnergyDiscoveryTimeout() est supérieur à 0, le signal n'est émis que lorsqu'au moins un attribut de info change. Cela reflète le désir de recevoir des mises à jour au fur et à mesure que des informations plus précises sont disponibles. L'exception à ce comportement est le cas où lowEnergyDiscoveryTimeout est défini comme 0. Un délai d'attente de 0 exprime le souhait de surveiller l'apparition et la disparition des dispositifs à faible consommation d'énergie au fil du temps. Dans ce cas, le signal deviceDiscovered() est émis même si info n'a pas changé depuis la dernière émission de 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 sur l'appareil Bluetooth décrit par info. Les drapeaux updatedFields indiquent quelles informations ont été mises à jour.

Au cours de la découverte, certaines informations peuvent changer de manière dynamique, comme signal strength et manufacturerData. Ce signal vous informe que si votre application affiche ces données, elle peut être mise à jour, plutôt que d'attendre la fin de la découverte.

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

QList<QBluetoothDeviceInfo> QBluetoothDeviceDiscoveryAgent::discoveredDevices() const

Renvoie une liste de tous les appareils Bluetooth découverts.

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 recherche.

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

Ce signal est émis lorsqu'une erreur error se produit lors de la découverte d'un appareil Bluetooth. Le paramètre error décrit l'erreur qui s'est produite.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi error() et errorString().

QString QBluetoothDeviceDiscoveryAgent::errorString() const

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

Voir aussi error() et errorOccurred().

[signal] void QBluetoothDeviceDiscoveryAgent::finished()

Ce signal est émis lorsque la découverte du périphérique Bluetooth est terminée. Le signal n'est pas émis si la découverte de l'appareil se termine par une erreur.

bool QBluetoothDeviceDiscoveryAgent::isActive() const

Retourne true si l'agent est en train de découvrir des appareils Bluetooth, sinon retourne false.

int QBluetoothDeviceDiscoveryAgent::lowEnergyDiscoveryTimeout() const

Renvoie un délai d'attente en millisecondes appliqué à la recherche de périphériques Bluetooth Low Energy. Une valeur de -1 signifie que la plate-forme ne prend pas en charge cette propriété et que le délai d'attente pour la recherche de périphériques ne peut pas être ajusté. Une valeur de retour de 0 implique une recherche sans fin qui doit être arrêtée manuellement via stop().

Voir également setLowEnergyDiscoveryTimeout().

void QBluetoothDeviceDiscoveryAgent::setLowEnergyDiscoveryTimeout(int timeout)

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

Cela reflète le fait que le processus de découverte des dispositifs Bluetooth Low Energy est en grande partie ouvert. La plateforme continue à rechercher d'autres dispositifs jusqu'à ce que la recherche soit arrêtée manuellement. Le délai d'attente 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 du délai d'attente ne prend effet qu'après le redémarrage de la recherche de l'appareil. En outre, le délai d'attente n'affecte pas la recherche classique de périphériques Bluetooth. En fonction de la plate-forme, la recherche classique peut ajouter plus de temps au processus de découverte total au-delà de timeout.

Pour une découverte fiable de Bluetooth Low Energy, utilisez au moins 40000 millisecondes.

Voir également lowEnergyDiscoveryTimeout().

[slot] void QBluetoothDeviceDiscoveryAgent::start()

Démarre la découverte des appareils Bluetooth, si elle n'est pas déjà lancée.

Le signal deviceDiscovered() est émis au fur et à mesure de la découverte de chaque appareil. Le signal finished() est émis lorsque la découverte des périphériques est terminée. La découverte utilise le maximum de méthodes de découverte prises en charge sur la plate-forme.

// 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 aussi supportedDiscoveryMethods().

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

Lance la recherche de périphériques Bluetooth, si elle n'est pas déjà lancée et si les methods fournis sont pris en charge. La découverte methods limite la portée de la recherche de périphériques. Par exemple, si le service ou le dispositif cible est un dispositif Bluetooth Low Energy, cette fonction peut être utilisée pour limiter la recherche aux dispositifs Bluetooth Low Energy, ce qui réduit considérablement le temps de recherche.

// 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 découverte des appareils Bluetooth. Le signal cancel() est émis une fois que la découverte de l'appareil est annulée. start() peut être appelé avant que le signal d'annulation ne soit reçu. Une fois que start() a été appelé, le signal d'annulation de la découverte précédente est supprimé.

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

Cette fonction renvoie les méthodes de découverte prises en charge par la plate-forme actuelle. Elle peut être utilisée pour limiter la portée de la découverte de l'appareil.