QBluetoothLocalDevice Class

Documentation sur les fonctions des membres

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

Construit un QBluetoothLocalDevice avec parent.

Voir aussi isValid().

[explicit] QBluetoothLocalDevice::QBluetoothLocalDevice(const QBluetoothAddress &address, QObject *parent = 0)

Construit un nouveau QBluetoothLocalDevice pour address. Si address est construit par défaut, le périphérique local résultant sélectionne le périphérique local par défaut.

Voir aussi isValid().

[virtual noexcept] QBluetoothLocalDevice::~QBluetoothLocalDevice()

Détruit le site QBluetoothLocalDevice.

QBluetoothAddress QBluetoothLocalDevice::address() const

Renvoie l'adresse MAC de ce périphérique Bluetooth.

[static] QList<QBluetoothHostInfo> QBluetoothLocalDevice::allDevices()

Renvoie une liste de tous les périphériques Bluetooth locaux disponibles. Sous macOS, il n'y a que le périphérique local "par défaut".

QList<QBluetoothAddress> QBluetoothLocalDevice::connectedDevices() const

Renvoie la liste des appareils connectés. Cette liste est différente de la liste des appareils actuellement appariés.

Sur Android et macOS, il n'est pas possible de récupérer une liste d'appareils connectés. Il est seulement possible d'écouter les changements de (dé)connexion. Pour des raisons pratiques, cette classe surveille tous les événements de connexion et de déconnexion depuis son instanciation et renvoie la liste actuelle lors de l'appel de cette fonction. Il est donc possible que cette fonction renvoie une liste vide peu après la création d'une instance.

Voir aussi deviceConnected() et deviceDisconnected().

[signal] void QBluetoothLocalDevice::deviceConnected(const QBluetoothAddress &address)

Ce signal est émis lorsque le dispositif local établit une connexion avec un dispositif distant à l'aide de address.

Voir également deviceDisconnected() et connectedDevices().

[signal] void QBluetoothLocalDevice::deviceDisconnected(const QBluetoothAddress &address)

Ce signal est émis lorsque l'appareil local se déconnecte d'un appareil Bluetooth distant avec address.

Voir également deviceConnected() et connectedDevices().

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

Signal émis en cas d'anomalie sur error lors de l'appairage.

Cette fonction a été introduite dans Qt 6.2.

QBluetoothLocalDevice::HostMode QBluetoothLocalDevice::hostMode() const

Renvoie le mode hôte actuel de ce périphérique Bluetooth local. Sous macOS, il s'agit de HostPoweredOff ou HostConnectable.

Voir aussi setHostMode().

[signal] void QBluetoothLocalDevice::hostModeStateChanged(QBluetoothLocalDevice::HostMode state)

Le site state de l'hôte est passé à un autre site HostMode.

bool QBluetoothLocalDevice::isValid() const

Renvoie true si le site QBluetoothLocalDevice représente un appareil Bluetooth local disponible ; sinon, renvoie false.

Si l'adaptateur Bluetooth local représenté par une instance de cette classe est retiré du système (par exemple, retrait du dongle Bluetooth sous-jacent), cette instance devient invalide. Une instance QBluetoothLocalDevice déjà invalide reste invalide même si le même adaptateur Bluetooth est réintroduit dans le système.

Voir aussi allDevices().

QString QBluetoothLocalDevice::name() const

Renvoie le nom attribué par l'utilisateur à ce périphérique Bluetooth.

[signal] void QBluetoothLocalDevice::pairingFinished(const QBluetoothAddress &address, QBluetoothLocalDevice::Pairing pairing)

L'appairage ou le désappairage est terminé avec address. L'état actuel de l'appairage est indiqué dans pairing. Si la demande d'appairage n'a pas abouti, ce signal n'est pas émis. Le signal errorOccurred() est émis si la demande d'appairage a échoué. Le signal n'est jamais émis que pour les demandes d'appariement qui ont été demandées précédemment en appelant requestPairing() de l'instance d'objet actuelle.

QBluetoothLocalDevice::Pairing QBluetoothLocalDevice::pairingStatus(const QBluetoothAddress &address) const

Renvoie l'état actuel de l'appairage bluetooth de address, s'il est non apparié, apparié ou apparié et autorisé.

void QBluetoothLocalDevice::powerOn()

Met l'appareil sous tension après l'avoir ramené à l'état hostMode(), s'il était hors tension.

void QBluetoothLocalDevice::requestPairing(const QBluetoothAddress &address, QBluetoothLocalDevice::Pairing pairing)

Définissez l'état de pairing à l'aide de address. Les résultats sont renvoyés par le signal pairingFinished().

Sur Android et macOS, AuthorizedPaired n'est pas possible et aura le même comportement que Paired. Sous Windows, c'est le système d'exploitation qui décide du mode d'appariement exact.

Sous macOS, il n'est pas possible de désapparier un appareil. Si Unpaired est demandé, pairingFinished() est immédiatement émis bien que l'appareil reste apparié. Il est possible de demander l'appairage d'un appareil qui n'a pas été apparié auparavant. En outre, AuthorizedPaired a le même comportement que Paired.

Attention : la création d'un jumelage peut prendre plusieurs minutes et peut nécessiter un accusé de réception de la part de l'utilisateur.

void QBluetoothLocalDevice::setHostMode(QBluetoothLocalDevice::HostMode mode)

Définit le mode hôte de ce périphérique Bluetooth local sur mode.

Certaines transitions, telles que l'activation ou la désactivation de l'appareil, peuvent prendre un certain temps. C'est pourquoi les appels suivants ne doivent être effectués qu'une fois que le signal hostModeStateChanged() a mis fin à la demande précédente. Si ce signal est ignoré, le résultat d'une telle série d'appels n'est pas bien défini.

Voir également hostMode().